dotbrain 0.7.0__tar.gz → 0.8.0__tar.gz

{dotbrain-0.7.0 → dotbrain-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: dotbrain
-Version: 0.7.0
+Version: 0.8.0
 Summary: Wires project Brainspaces and skills into coding agents.
 Project-URL: Homepage, https://github.com/arminzou/dotbrain
 Project-URL: Repository, https://github.com/arminzou/dotbrain

{dotbrain-0.7.0 → dotbrain-0.8.0}/docs/cli-reference.md

@@ -8,7 +8,9 @@ for catalogs and project inspection. Empty lists, previews, and skipped work are
 Doctor shows problems and warnings first; use `doctor -v` to include every healthy check.
 Runtime activation and session uncertainty are informational, shown with `doctor -v` and in
 JSON; they do not count as passed checks. Missing registered hook files and failed plugin
-checks remain warnings.
+checks remain warnings. With `--all`, a project whose shared `.repo` checkout is absent on this
+machine is reported as skipped, not failed; a missing `.repo.local` checkout or an explicit
+`--project` still fails.
 Colors follow terminal capabilities; redirected output stays plain.
 
 Finite reports support `--json`: stdout contains one result with command, overall status,
@@ -94,7 +96,6 @@ dotbrain wire [OPTIONS]
 | --- | --- | --- |
 | `--repo` *path* | — | Checkout to attach; defaults to the current Git checkout. |
 | `--project` *text* | — | Select a named Brainspace. |
-| `--no-repo` | — | Create a Brain-only project; requires `--project`. |
 | `--skip-beads` | — | Create without a tracker. |
 | `--remote` *text* | — | Dolt remote for initial tracker creation. |
 | `--server-host` *text* | — | Dolt server host; defaults to config. |

{dotbrain-0.7.0 → dotbrain-0.8.0}/docs/glossary.md

@@ -33,9 +33,11 @@ agent-facing conventions. In dotbrain terms, the Brain is narrower than the full
 
 ### Brain-only project
 
-A project created without a code checkout, using `dotbrain wire --no-repo --project <name>`.
-It can still have an execution store. Add `--skip-beads` to create it without a tracker;
-tracker-free projects can also have wired checkouts.
+A retired kind of project with no code checkout. `dotbrain wire --no-repo` no longer exists: every
+project has a repository as its working home. That repository can be private and hold only
+documents. To migrate a Brain-only Brainspace, run `dotbrain wire --project <name>` from its new
+repository, or move the Brainspace out of `brainspaces/` to archive it. Add `--skip-beads` to
+create a project without a tracker.
 
 ### ADR
 

{dotbrain-0.7.0 → dotbrain-0.8.0}/docs/troubleshooting.md

@@ -94,7 +94,9 @@ Yes. Set `DOTBRAIN_HOME` to the directory you want.
 
 ### Can I use dotbrain without a code repo?
 
-Yes. `dotbrain wire --no-repo --project <project>` creates a Brain-only Brainspace.
+Not anymore. Every project needs a repository as its working home, but it can be a private
+repository that holds only documents. To move an older Brain-only project onto one, run
+`dotbrain wire --project <project>` from that repository.
 
 ### How do I stop using dotbrain on a repo?
 

{dotbrain-0.7.0 → dotbrain-0.8.0}/docs/wiring.md

@@ -72,10 +72,6 @@ dotbrain wire
 dotbrain wire --repo ~/repos/my-app
 ```
 
-```bash [Brain only]
-dotbrain wire --no-repo --project research
-```
-
 :::
 
 `wire` creates or repairs:
@@ -146,8 +142,10 @@ tracker state. Named selection and `--all` use registered checkouts rather than
 ## Selection and reports
 
 Project commands default to the current wired checkout, including its subdirectories. Outside
-one, use `--project <name>`. Named selection respects `.repo.local` before `.repo`; Brain-only
-projects are valid for operations that do not need a checkout. Use `dotbrain projects list` and
+one, use `--project <name>`. Named selection respects `.repo.local` before `.repo`. A Brainspace with
+no registered checkout, such as an older Brain-only one, stays valid for operations that do not need
+a checkout; `doctor` warns about it, and `--all` asset linking skips it. Run
+`dotbrain wire --project <name>` from a repository to register one. Use `dotbrain projects list` and
 `dotbrain projects show` to inspect identities and resolved settings without remote probes.
 
 `--all` conflicts with `--project` and `--repo`. Applicable leaf commands accept `--home <path>`

{dotbrain-0.7.0 → dotbrain-0.8.0}/docs/zh/cli-reference.md

@@ -5,7 +5,8 @@
 面向人的输出会按目标对改动和问题分组，把主目录路径缩写成 `~`，并用表格展示目录和项目信息。空列表、预览和
 被跳过的操作都会明确显示。doctor 先显示问题和警告；用 `doctor -v` 可以包括所有健康的检查项。运行时激活状态和
 会话的不确定性属于参考信息，只在 `doctor -v` 和 JSON 中显示，不算作通过的检查。缺失的已注册 hook 文件和失败的
-插件检查仍然是警告。颜色会根据终端能力调整；重定向的输出保持纯文本。
+插件检查仍然是警告。使用 `--all` 时，如果项目共享的 `.repo` checkout 不在本机上，该项目显示为跳过而不是失败；
+`.repo.local` 指向的 checkout 缺失，或用 `--project` 明确选择时，仍然报错。颜色会根据终端能力调整；重定向的输出保持纯文本。
 
 一次性输出结果的命令支持 `--json`：stdout 包含一个结果，里面有命令、总体状态、每个目标的结果和错误。
 问题的严重级别有 `info`、`warning` 和 `error`；只有 warning 时不算失败。退出码 `0` 表示成功，`1` 表示操作失败或
@@ -89,7 +90,6 @@ dotbrain wire [OPTIONS]
 | --- | --- | --- |
 | `--repo` *path* | — | 要连接的 checkout；默认是当前的 Git checkout。 |
 | `--project` *text* | — | 选择一个指定的 Brainspace。 |
-| `--no-repo` | — | 创建只有 Brain 的项目；需要 `--project`。 |
 | `--skip-beads` | — | 创建时不带任务跟踪。 |
 | `--remote` *text* | — | 首次创建任务跟踪时使用的 Dolt remote。 |
 | `--server-host` *text* | — | Dolt 服务器主机；默认取自配置。 |

{dotbrain-0.7.0 → dotbrain-0.8.0}/docs/zh/glossary.md

@@ -31,8 +31,10 @@ Brainspace 小。
 
 ### Brain-only project
 
-没有代码 checkout 的项目，用 `dotbrain wire --no-repo --project <name>` 创建。它仍然可以有执行存储。加上
-`--skip-beads` 可以创建一个没有任务跟踪的项目；没有任务跟踪的项目也可以连接 checkout。
+已经停用的项目类型，没有代码 checkout。`dotbrain wire --no-repo` 已经移除：每个项目都以一个仓库作为工作目录。
+这个仓库可以是私有的，只放文档。要迁移 Brain-only 的 Brainspace，在新仓库里运行
+`dotbrain wire --project <name>`；或者把 Brainspace 移出 `brainspaces/` 归档。加上 `--skip-beads` 可以创建一个
+没有任务跟踪的项目。
 
 ### ADR
 

{dotbrain-0.7.0 → dotbrain-0.8.0}/docs/zh/troubleshooting.md

@@ -86,7 +86,8 @@ dotbrain wire --repo ~/repos/my-app
 
 ### 没有代码仓库能用 dotbrain 吗？ {#can-i-use-dotbrain-without-a-code-repo}
 
-可以。`dotbrain wire --no-repo --project <project>` 会创建一个只有 Brain 的 Brainspace。
+现在不行了。每个项目都需要一个仓库作为工作目录，不过它可以是只放文档的私有仓库。要把以前的 Brain-only 项目
+迁过去，在那个仓库里运行 `dotbrain wire --project <project>`。
 
 ### 怎么让某个仓库不再使用 dotbrain？ {#how-do-i-stop-using-dotbrain-on-a-repo}
 

{dotbrain-0.7.0 → dotbrain-0.8.0}/docs/zh/wiring.md

@@ -70,10 +70,6 @@ dotbrain wire
 dotbrain wire --repo ~/repos/my-app
 ```
 
-```bash [只建 Brain]
-dotbrain wire --no-repo --project research
-```
-
 :::
 
 `wire` 会创建或修复：
@@ -143,7 +139,9 @@ worktree 里运行不带参数的维护命令和资源链接命令，只影响
 ## 选择项目与结果输出 {#selection-and-reports}
 
 项目命令默认作用于当前已连接的 checkout，包括它的子目录。在它之外，请用 `--project <name>`。按名字选择时，
-`.repo.local` 优先于 `.repo`；对于不需要 checkout 的操作，只有 Brain 的项目也是有效的。用
+`.repo.local` 优先于 `.repo`。没有注册 checkout 的 Brainspace（比如以前的 Brain-only 项目）仍然可以用于不需要
+checkout 的操作；`doctor` 会给出警告，`--all` 链接资源时会跳过它。在仓库里运行 `dotbrain wire --project <name>`
+就能注册 checkout。用
 `dotbrain projects list` 和 `dotbrain projects show` 查看项目身份和解析后的设置，不会探测远程。
 
 `--all` 不能和 `--project`、`--repo` 一起用。适用的子命令都接受 `--home <path>` 和 `--json`。JSON 输出是

{dotbrain-0.7.0 → dotbrain-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dotbrain"
-version = "0.7.0"
+version = "0.8.0"
 description = "Wires project Brainspaces and skills into coding agents."
 readme = "README.md"
 requires-python = ">=3.11"

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/__init__.py

@@ -4,4 +4,4 @@ A testable Python CLI for wiring repos into Brainspaces, seeding Brains, and
 managing skills. Exposes the workflow commands plus pure path/contract helpers.
 """
 
-__version__ = "0.7.0"
+__version__ = "0.8.0"

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/_cli_reference.py

@@ -55,7 +55,9 @@ for catalogs and project inspection. Empty lists, previews, and skipped work are
 Doctor shows problems and warnings first; use `doctor -v` to include every healthy check.
 Runtime activation and session uncertainty are informational, shown with `doctor -v` and in
 JSON; they do not count as passed checks. Missing registered hook files and failed plugin
-checks remain warnings.
+checks remain warnings. With `--all`, a project whose shared `.repo` checkout is absent on this
+machine is reported as skipped, not failed; a missing `.repo.local` checkout or an explicit
+`--project` still fails.
 Colors follow terminal capabilities; redirected output stays plain.
 
 Finite reports support `--json`: stdout contains one result with command, overall status,

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/adopter_repos.py

@@ -123,7 +123,7 @@ def repo_for_brainspace(
     3. dotbrain_home itself when brainspace.name == "dotbrain"
     4. repo_base/<brainspace.name> when the directory exists
 
-    A ``(brain-only)`` pointer resolves to ``None``: the Brainspace declares no adopter repo.
+    A retired ``(brain-only)`` pointer resolves to ``None``: it names no checkout.
     """
     for pointer_name in (".repo.local", ".repo"):
         pointer = brainspace / pointer_name
@@ -226,7 +226,7 @@ def repo_root(repo: Path | None, run: Runner = _default_run) -> Path:
         res = run(argv, cwd=cwd, check=True)
     except subprocess.CalledProcessError:
         loc = str(cwd) if cwd else "current directory"
-        raise ValueError(f"{loc} is not inside a git repository; select --project <name> or use wire --no-repo --project <name>")
+        raise ValueError(f"{loc} is not inside a git repository; run from a Git checkout or select --project <name>")
     return Path((res.stdout or "").strip()).resolve()
 
 

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/asset_cli.py

@@ -35,7 +35,7 @@ def report(kind, operation, home, runtime, project, json_output, scope="project"
                 result.targets.append(item)
                 try:
                     if target and target.checkout is None and all_projects:
-                        item.findings.append({"severity": "warning", "message": "Brain-only project: no checkout assets"})
+                        item.findings.append({"severity": "warning", "message": paths.NO_CHECKOUT})
                         continue
                     linked = assets.link_global(root, kind, runtime) if target is None else assets.link_project(root, target, kind, runtime)
                     item.changes = [f"delivered {name}" for name in linked.linked] + [f"pruned {name}" for name in linked.pruned]

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/brainspaces.py

@@ -94,35 +94,9 @@ def active_agent_workspaces(brainspace: Path, dotbrain_home: Path) -> tuple[str,
     return tuple(f".{agent}" for agent in agents if agent in _KNOWN_AGENT_WORKSPACES)
 
 
-def is_brain_only(brainspace: Path) -> bool:
-    """True when the Brainspace declares no adopter repo."""
-
-    repo_file = Path(brainspace) / ".repo"
-    return (
-        repo_file.is_file()
-        and repo_file.read_text(encoding="utf-8").strip() == "(brain-only)"
-    )
-
-
-def seed_agent_workspaces(brainspace: Path, dotbrain_home: Path, home: Path | None = None) -> list[str]:
-    """Create declared agent workspaces, but only for a brain-only Brainspace.
-
-    A repo-backed Brainspace has its workspaces materialized in the code repo, and skill and
-    subagent links point from there straight at the dotbrain home. Seeding one here too would
-    leave directories nothing reads. A brain-only Brainspace has no repo, so it is the only
-    place its links can live.
-
-    Undeclared agents still warn either way: a typo in ``project.yaml`` should not be silent.
-    """
+def unknown_agent_warnings(brainspace: Path, dotbrain_home: Path) -> list[str]:
+    """Warn on undeclared agents: a typo in ``project.yaml`` should not be silent."""
     brainspace = Path(brainspace)
-    warnings: list[str] = []
-    brain_only = is_brain_only(brainspace)
-
-    for agent in config.load_project_agents(dotbrain_home, brainspace.name):
-        if agent not in _KNOWN_AGENT_WORKSPACES:
-            warnings.append(f"ignored unknown agent workspace in {brainspace / '.brain' / 'project.yaml'}: {agent}")
-            continue
-        if brain_only:
-            (brainspace / f".{agent}").mkdir(parents=True, exist_ok=True)
-
-    return warnings
+    return [f"ignored unknown agent workspace in {brainspace / '.brain' / 'project.yaml'}: {agent}"
+            for agent in config.load_project_agents(dotbrain_home, brainspace.name)
+            if agent not in _KNOWN_AGENT_WORKSPACES]

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/cli.py

@@ -166,7 +166,6 @@ def doctor(home: HomeOption = None,
 def wire(
     repo: Optional[Path] = typer.Option(None, '--repo', help='Checkout to attach; defaults to the current Git checkout.'),
     project: Optional[str] = typer.Option(None, '--project', help='Select a named Brainspace.'),
-    no_repo: bool = typer.Option(False, '--no-repo', help='Create a Brain-only project; requires --project.'),
     skip_beads: bool = typer.Option(False, '--skip-beads', help='Create without a tracker.'),
     remote: str = typer.Option('', '--remote', help='Dolt remote for initial tracker creation.'),
     server_host: Optional[str] = typer.Option(None, '--server-host', help='Dolt server host; defaults to config.'),
@@ -183,7 +182,7 @@ def wire(
         if remote and selected_host:
             raise ValueError('--remote and --server-host are mutually exclusive')
         with activity("Wiring project...", enabled=not json_output):
-            result = workflows.wire_project(dotbrain_home=root, repo=repo, project=project, no_repo=no_repo,
+            result = workflows.wire_project(dotbrain_home=root, repo=repo, project=project,
                     run_beads=not skip_beads, remote=remote, server_host=selected_host,
                     server_port=cfg.port if server_port is None else server_port,
                     server_user=cfg.user if server_user is None else server_user, database=database)

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/doctor.py

@@ -245,7 +245,7 @@ def _check_beads_state(brainspace: Path, name: str, dotbrain_home: Path, *, run:
     return findings
 
 
-def _check_project(target: projects.ProjectTarget, root: Path, run: Runner) -> list[Finding]:
+def _check_project(target: projects.ProjectTarget, root: Path, run: Runner, *, skip_absent: bool = False) -> list[Finding]:
     findings = []
     beads = config.load_project_config(root, target.project)
     workspaces = assets.project_workspaces(root, target, "all")
@@ -255,7 +255,12 @@ def _check_project(target: projects.ProjectTarget, root: Path, run: Runner) -> l
         findings.append(Finding("error", "Brain directory missing", "run dotbrain refresh"))
     repo = target.checkout
     if repo is None:
-        findings.append(Finding("ok", "Brain-only project: no checkout assets"))
+        findings.append(Finding("warn", paths.NO_CHECKOUT,
+                                f"run dotbrain wire --project {target.project} from its repository, or archive the Brainspace"))
+    elif not repo.is_dir() and skip_absent and not (target.brainspace / ".repo.local").is_file():
+        # A shared .repo may name a checkout that lives only on another machine.
+        findings.append(Finding("skip", "checkout not on this machine; checkout checks skipped",
+                                "add .repo.local to check a checkout here"))
     elif not repo.is_dir():
         findings.append(Finding("error", f"registered checkout missing: {repo}", "correct .repo.local or .repo"))
     else:
@@ -304,7 +309,7 @@ def run_doctor(dotbrain_home: Path, home: Path | None = None, *, project: str |
     for target in targets:
         report.checkouts[target.project] = str(target.checkout) if target.checkout else None
         try:
-            report.projects[target.project] = _check_project(target, root, run)
+            report.projects[target.project] = _check_project(target, root, run, skip_absent=all_projects)
         except DIAGNOSIS_ERRORS as exc:
             report.projects[target.project] = [Finding("error", f"project diagnosis failed: {exc}", "correct the declaration or inaccessible paths")]
     return report
@@ -317,9 +322,11 @@ def as_result(report: DoctorReport) -> CommandResult:
         item = TargetResult(project=name, checkout=report.checkouts.get(name), scope=scope)
         for finding in findings:
             message = finding.message + (f"; {finding.suggestion}" if finding.suggestion else "")
-            item.findings.append({"severity": {"ok": "info", "info": "info", "warn": "warning", "error": "error"}[finding.status], "message": message})
+            item.findings.append({"severity": {"ok": "info", "info": "info", "skip": "info", "warn": "warning", "error": "error"}[finding.status], "message": message})
         if any(f.status == "error" for f in findings):
             item.status = "failure"
+        elif any(f.status == "skip" for f in findings):
+            item.status = "skipped"
         result.targets.append(item)
     failures = sum(item.status == "failure" for item in result.targets)
     if failures:

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/paths.py

@@ -21,6 +21,9 @@ DATA_DIRS: tuple[str, ...] = ("brainspaces", "projects")
 # Matching anchored entries written to an adopter repo's .git/info/exclude.
 EXCLUDE_ENTRIES: tuple[str, ...] = ("/.brain", "/.beads")
 
+# Reported for a Brainspace with no registered checkout, such as a retired Brain-only one.
+NO_CHECKOUT = "no registered checkout"
+
 # Breadcrumb appended to an adopter repo's real AGENTS.md / CLAUDE.md.
 ADOPTER_POINTER: str = (
     "@.brain/CLAUDE.md\n"

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/presentation.py

@@ -13,6 +13,7 @@ from rich.padding import Padding
 from rich.table import Table
 from rich.text import Text
 
+from dotbrain import paths
 from dotbrain.adopter_repos import abbrev_home
 
 HEADING_STYLE = "bold green"
@@ -149,7 +150,7 @@ def _messages(output: Console, messages: list[str], severity: str, checkout: str
 
 
 def _human_status(target) -> str:
-    if target.status == "success" and any(f["message"] == "Brain-only project: no checkout assets" for f in target.findings):
+    if target.status == "success" and any(f["message"] == paths.NO_CHECKOUT for f in target.findings):
         return "skipped"
     return target.status
 
@@ -176,7 +177,7 @@ def render_operation(result, *, preview: bool = False) -> None:
         if target.checkout:
             label += " · " + abbrev_home(Path(target.checkout))
         elif target.project:
-            label += " · Brain-only"
+            label += " · no checkout"
         line(output, label, NAME_STYLE)
         _messages(output, target.errors, "error", target.checkout)
         for finding in target.findings:
@@ -258,7 +259,7 @@ def render_catalog(result) -> None:
 
 
 def _wiring(record) -> str:
-    if record["brain_only"]:
+    if record["checkout"] is None:
         return "No checkout"
     problems = [f"{name} {status}" for name, status in record["wiring"].items() if status != "healthy"]
     return ", ".join(problems) or "Healthy"
@@ -276,8 +277,8 @@ def render_projects(result) -> None:
         for record in records:
             failure = "error" in record
             wiring = "Declaration error" if failure else _wiring(record)
-            rows.append([record["project"], abbrev_home(Path(record["checkout"])) if record["checkout"] else "Brain-only",
-                         text(wiring, output, "red" if failure or wiring not in {"Healthy", "No checkout"} else "green"),
+            rows.append([record["project"], abbrev_home(Path(record["checkout"])) if record["checkout"] else "-",
+                         text(wiring, output, "red" if failure or wiring != "Healthy" else "green"),
                          *([] if shared_runtime else ["unknown" if failure else _runtimes(record["runtimes"])]),
                          *([] if shared_tracker else ["unknown" if failure else record["beads"]["mode"]])])
         if rows:
@@ -299,7 +300,7 @@ def render_projects(result) -> None:
         record = target.data
         output.print(Text.assemble(text("Project: ", output, HEADING_STYLE),
                                    text(target.project, output, NAME_STYLE)))
-        table(output, ["Property", "Value"], [["Checkout", record["checkout"] or "Brain-only"],
+        table(output, ["Property", "Value"], [["Checkout", record["checkout"] or "none"],
               ["Runtimes", _runtimes(record["runtimes"])], ["Tracker", record["beads"]["mode"]], ["Wiring", _wiring(record)]])
         line(output, "Paths", HEADING_STYLE)
         table(output, ["Path", "Location"], [["Brainspace", record["brainspace"]],
@@ -327,15 +328,16 @@ def render_doctor(report, *, verbose: bool = False) -> None:
     def counted(count, noun):
         return f"{count} {noun}{'' if count == 1 else 's'}"
     passed = counted(counts["ok"], "check") + " passed"
-    line(output, counted(counts["error"], "problem") + " · " + counted(counts["warn"], "warning") + " · " + passed, "dim")
-    statuses = [("error", "red"), ("warn", "yellow")] + ([("ok", "green"), ("info", "dim")] if verbose else [])
+    skipped = f" · {counts['skip']} skipped" if counts["skip"] else ""
+    line(output, counted(counts["error"], "problem") + " · " + counted(counts["warn"], "warning") + " · " + passed + skipped, "dim")
+    statuses = [("error", "red"), ("warn", "yellow"), ("skip", "dim")] + ([("ok", "green"), ("info", "dim")] if verbose else [])
     for status, style in statuses:
         for name, checkout, findings in groups:
             selected = [finding for finding in findings if finding.status == status]
             if not selected:
                 continue
             line(output)
-            marker = symbol(output, False) if status == "error" else "!" if status == "warn" else "i" if status == "info" else symbol(output, True)
+            marker = symbol(output, False) if status == "error" else "!" if status == "warn" else "-" if status == "skip" else "i" if status == "info" else symbol(output, True)
             line(output, f"{marker} {name}" + (" · " + abbrev_home(Path(checkout)) if checkout else ""), "bold " + style)
             combined = {}
             for finding in selected:

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/projects.py

@@ -88,7 +88,7 @@ def inspect_project(home: Path, target: ProjectTarget, *, expand_assets: bool =
     return {
         "project": target.project, "brainspace": str(target.brainspace),
         "checkout": str(target.checkout) if target.checkout is not None else None,
-        "brain_only": target.checkout is None, "runtimes": list(runtimes),
+        "runtimes": list(runtimes),
         "paths": {"brain": str(paths.confined_path(target.brainspace, ".brain")),
                   "execution": str(paths.confined_path(target.brainspace, ".beads"))
                   if beads.mode != "none" else None,

{dotbrain-0.7.0 → dotbrain-0.8.0}/src/dotbrain/workflows.py

@@ -94,7 +94,6 @@ def wire_project(
     dotbrain_home: Path,
     repo: Path | None = None,
     project: str | None = None,
-    no_repo: bool = False,
     run_beads: bool = True,
     remote: str = "",
     server_host: str = "",
@@ -109,23 +108,15 @@ def wire_project(
     if not (dotbrain_home / ".git").exists():
         raise RuntimeError(f"{dotbrain_home} is not a dotbrain git checkout")
 
-    resolved_repo: Path | None
-    if no_repo:
-        if repo is not None:
-            raise ValueError("--no-repo cannot be combined with --repo")
-        if not project:
-            raise ValueError("--no-repo requires --project <name>")
-        resolved_repo = None
-    else:
-        resolved_repo = adopter_repos.repo_root(repo, run)
-        adopter_repos.ensure_not_wired_to_foreign_dotbrain(resolved_repo, dotbrain_home)
-        if (resolved_repo / ".brain").is_symlink():
-            wired = project_selection._wired(dotbrain_home, resolved_repo)
-            if project is not None and project != wired.project:
-                raise ValueError("--project does not match this checkout's Brainspace")
-            project = wired.project
-
-    parent = adopter_repos.linked_worktree_parent(resolved_repo, run) if resolved_repo else None
+    resolved_repo = adopter_repos.repo_root(repo, run)
+    adopter_repos.ensure_not_wired_to_foreign_dotbrain(resolved_repo, dotbrain_home)
+    if (resolved_repo / ".brain").is_symlink():
+        wired = project_selection._wired(dotbrain_home, resolved_repo)
+        if project is not None and project != wired.project:
+            raise ValueError("--project does not match this checkout's Brainspace")
+        project = wired.project
+
+    parent = adopter_repos.linked_worktree_parent(resolved_repo, run)
     if parent is not None:
         main = project_selection.select_projects(dotbrain_home, repo=parent, run=run)[0]
         if project is not None and project != main.project:
@@ -137,15 +128,14 @@ def wire_project(
     # Resolve identity and every managed destination before even root housekeeping:
     # rejecting a selector must not seed a phantom project or rewrite registration.
     paths.brainspace_link_targets(dotbrain_home, project)
-    for relative in (".repo", ".repo.local", ".brain/project.yaml", ".claude", ".codex"):
+    for relative in (".repo", ".repo.local", ".brain/project.yaml"):
         paths.confined_path(brainspace, relative)
     paths.confined_path(dotbrain_home, ".gitignore")
-    if resolved_repo is not None:
-        adopter_repos.ensure_wiring_matches(resolved_repo, dotbrain_home, project)
-        for name in (".brain", ".beads"):
-            entry = resolved_repo / name
-            if entry.exists() and not entry.is_symlink():
-                raise ValueError(f"{entry}: a user-owned entry conflicts with attachment")
+    adopter_repos.ensure_wiring_matches(resolved_repo, dotbrain_home, project)
+    for name in (".brain", ".beads"):
+        entry = resolved_repo / name
+        if entry.exists() and not entry.is_symlink():
+            raise ValueError(f"{entry}: a user-owned entry conflicts with attachment")
     existing = brainspace.is_dir()
     if existing:
         legacy = brainspace / ".brain/agents/skills.yaml"
@@ -168,44 +158,37 @@ def wire_project(
     rel = paths.data_dir(dotbrain_home).name
     bootstrap.ensure_root_gitignore(dotbrain_home)
     brainspace.mkdir(parents=True, exist_ok=True)
-    if no_repo and not existing:
-        (brainspace / ".repo").write_text(
-            "(brain-only)\n", encoding="utf-8", newline="\n"
-        )
-    elif not existing:
-        assert resolved_repo is not None
+    if not existing:
         (brainspace / ".repo").write_text(
             f"{adopter_repos.abbrev_home(resolved_repo, home)}\n",
             encoding="utf-8",
             newline="\n",
         )
-    elif parent is None and resolved_repo is not None and adopter_repos.repo_for_brainspace(brainspace, dotbrain_home) is None:
+    elif parent is None and adopter_repos.repo_for_brainspace(brainspace, dotbrain_home) is None:
+        # A Brainspace without a usable pointer, including a retired Brain-only one, adopts this checkout.
         pointer = brainspace / (".repo.local" if (brainspace / ".repo.local").exists() else ".repo")
         paths.confined_path(brainspace, pointer.name)
         pointer.write_text(f"{adopter_repos.abbrev_home(resolved_repo, home)}\n", encoding="utf-8", newline="\n")
 
     result = WireResult(brainspace=brainspace, repo=resolved_repo, project=project)
-    missing_links = [name for name in paths.BRAINSPACE_LINKS
-                     if resolved_repo is not None and not (resolved_repo / name).is_symlink()]
+    missing_links = [name for name in paths.BRAINSPACE_LINKS if not (resolved_repo / name).is_symlink()]
     changed_workspaces = [name for name in brainspaces.active_agent_workspaces(brainspace, dotbrain_home)
-                          if resolved_repo is not None and
-                          ((resolved_repo / name).is_symlink() or not (resolved_repo / name).exists())]
+                          if (resolved_repo / name).is_symlink() or not (resolved_repo / name).exists()]
 
     if parent is None:
         result.logs += [f"shared Brain: updated {relative}" for relative in brainspaces.seed_brain(brainspace, dotbrain_home)]
     active_workspaces = brainspaces.active_agent_workspaces(brainspace, dotbrain_home)
-    result.warnings += brainspaces.seed_agent_workspaces(brainspace, dotbrain_home, home)
-    if resolved_repo is not None:
-        workspace_dirs, workspace_warnings = project_workspace_dirs(brainspace, resolved_repo, active_workspaces, run)
-        result.errors += workspace_warnings
-        result.logs += [f"materialized {name}" for name in changed_workspaces if name in workspace_dirs]
-        target = project_selection.ProjectTarget(project, brainspace, resolved_repo)
-        if not result.errors:
-            for kind in ("skills", "agents"):
-                linked = assets.link_project(dotbrain_home, target, kind, run=run)
-                result.errors += linked.warnings
-                result.logs += [f"linked {entry}" for entry in linked.linked]
-                result.logs += [f"pruned {entry}" for entry in linked.pruned]
+    result.warnings += brainspaces.unknown_agent_warnings(brainspace, dotbrain_home)
+    workspace_dirs, workspace_warnings = project_workspace_dirs(brainspace, resolved_repo, active_workspaces, run)
+    result.errors += workspace_warnings
+    result.logs += [f"materialized {name}" for name in changed_workspaces if name in workspace_dirs]
+    target = project_selection.ProjectTarget(project, brainspace, resolved_repo)
+    if not result.errors:
+        for kind in ("skills", "agents"):
+            linked = assets.link_project(dotbrain_home, target, kind, run=run)
+            result.errors += linked.warnings
+            result.logs += [f"linked {entry}" for entry in linked.linked]
+            result.logs += [f"pruned {entry}" for entry in linked.pruned]
     if existing and run_beads and parent is None:
         synced = beads.pull_beads_for_all(dotbrain_home, projects=[project], run=run)
         result.logs += _tracker_changes(synced)
@@ -237,10 +220,6 @@ def wire_project(
     if not existing:
         result.logs.append(f"created Brainspace at {rel}/{project}")
 
-    if no_repo:
-        return result
-
-    assert resolved_repo is not None
     result.warnings += adopter_repos.wire_repo(
         resolved_repo,
         brainspace,