campfire-cli 0.1.2__tar.gz → 0.1.3__tar.gz

{campfire_cli-0.1.2 → campfire_cli-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: campfire-cli
-Version: 0.1.2
+Version: 0.1.3
 Summary: Local-first shared context and governance CLI for humans and agents
 License-Expression: MIT
 License-File: LICENSE

{campfire_cli-0.1.2 → campfire_cli-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "campfire-cli"
-version = "0.1.2"
+version = "0.1.3"
 description = "Local-first shared context and governance CLI for humans and agents"
 readme = "README.md"
 license = "MIT"

{campfire_cli-0.1.2 → campfire_cli-0.1.3}/src/campfire_cli/__init__.py

@@ -1,3 +1,3 @@
 """Campfire CLI package."""
 
-__version__ = "0.1.2"
+__version__ = "0.1.3"

{campfire_cli-0.1.2 → campfire_cli-0.1.3}/src/campfire_cli/common/agent_hints.py

@@ -13,7 +13,8 @@ HINT_BODY = """## Campfire 文档治理
 本机装有 campfire CLI（`campfire --help`），Obsidian Vault 已注册为文档工作区。
 当用户要求"沉淀/记录/写文档/归档/跟踪问题"到知识库或项目文档时，先运行
 `campfire workspace resolve` 解析工作区，再按 campfire skill 流程处理；
-不要直接在代码仓库里创建笔记文件。"""
+不要直接在代码仓库里创建笔记文件。文档分类不确定时用"记录-"前缀兜底，
+字段规则以 `campfire document inspect` 返回的有效 Profile 为准。"""
 
 
 def default_hint_paths() -> list[Path]:

{campfire_cli-0.1.2 → campfire_cli-0.1.3}/src/campfire_cli/main.py

@@ -121,10 +121,40 @@ def tree(ctx: typer.Context) -> None:
 
 @app.command("setup")
 def setup(
-    workspace: Path = typer.Option(..., "--workspace", help="要初始化的 Workspace 根目录"),
+    workspace: Path | None = typer.Option(
+        None, "--workspace", help="要初始化的 Workspace 根目录；缺省时输出接入引导"
+    ),
     make_default: bool = typer.Option(False, "--default", help="设为默认 Workspace"),
 ) -> None:
     """从 .campfire.yaml 配置本机，或为已注册 Workspace 创建首份 Manifest。"""
+    if workspace is None:
+        typer.echo(
+            json.dumps(
+                {
+                    "status": "needs-input",
+                    "message": "需要指定 Vault 根目录；按场景选择以下入口之一",
+                    "paths": [
+                        {
+                            "scenario": "接入已有 Vault（目录已存在，含或不含 .campfire.yaml）",
+                            "command": "campfire setup --workspace <vault路径> --default",
+                        },
+                        {
+                            "scenario": "从零创建新 Workspace（初始化目录结构并注册）",
+                            "command": (
+                                "campfire workspace create --id <id> --path <路径> --default"
+                            ),
+                        },
+                        {
+                            "scenario": "暂不接入 Vault，仅安装全局资源（Skill 与提示词路标）",
+                            "command": "campfire upgrade",
+                        },
+                    ],
+                },
+                ensure_ascii=False,
+                indent=2,
+            )
+        )
+        return
     try:
         result = AppContainer.setup(workspace, make_default)
     except AppError as exc:

{campfire_cli-0.1.2 → campfire_cli-0.1.3}/tests/integration/test_cli.py

@@ -2146,3 +2146,15 @@ def test_upgrade_syncs_resources_and_accepts_update_alias(
     assert aliased["skills"]["status"] == "synced"
     assert aliased["agent_hints"][0]["action"] == "kept"
     assert stale.read_text(encoding="utf-8") != "过时内容\n"
+
+
+def test_setup_without_workspace_prints_guidance(tmp_path: Path, monkeypatch) -> None:
+    monkeypatch.setenv("CAMPFIRE_HOME", str(tmp_path / "home"))
+    result = runner.invoke(app, ["setup"])
+    assert result.exit_code == 0, result.output
+    payload = json.loads(result.output)
+    assert payload["status"] == "needs-input"
+    commands = {item["command"] for item in payload["paths"]}
+    assert "campfire setup --workspace <vault路径> --default" in commands
+    assert any("workspace create" in command for command in commands)
+    assert any("upgrade" in command for command in commands)

{campfire_cli-0.1.2 → campfire_cli-0.1.3}/uv.lock

@@ -36,7 +36,7 @@ wheels = [
 
 [[package]]
 name = "campfire-cli"
-version = "0.1.2"
+version = "0.1.3"
 source = { editable = "." }
 dependencies = [
     { name = "alembic" },