campfire-cli 0.1.0__py3-none-any.whl

campfire_cli/container.py

@@ -0,0 +1,130 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+from pathlib import Path
+
+from campfire_cli.app.base.repository.base_repository import BaseRepository
+from campfire_cli.app.base.service.base_service import BaseService
+from campfire_cli.app.decision.repository.decision_repository import SqliteDecisionRepository
+from campfire_cli.app.decision.service.decision_projection_service import (
+    DecisionProjectionService,
+)
+from campfire_cli.app.decision.service.decision_service import DecisionService
+from campfire_cli.app.maintenance.repository.maintenance_repository import (
+    SqliteMaintenanceRepository,
+)
+from campfire_cli.app.maintenance.service.maintenance_service import MaintenanceService
+from campfire_cli.app.skill.repository.skill_repository import SkillRepository
+from campfire_cli.app.skill.service.skill_service import SkillService
+from campfire_cli.app.workspace.repository.adoption_repository import SqliteAdoptionRepository
+from campfire_cli.app.workspace.repository.restructure_repository import (
+    SqliteRestructureRepository,
+)
+from campfire_cli.app.workspace.repository.workspace_repository import SqliteWorkspaceRepository
+from campfire_cli.app.workspace.service.adoption_service import AdoptionService
+from campfire_cli.app.workspace.service.config_service import WorkspaceConfigService
+from campfire_cli.app.workspace.service.domain_restructure_service import (
+    DomainRestructureService,
+)
+from campfire_cli.app.workspace.service.restructure_service import RestructureService
+from campfire_cli.app.workspace.service.workspace_service import WorkspaceService
+from campfire_cli.common.database import create_sqlite_engine, open_session, upgrade_database
+from campfire_cli.common.exceptions import ConfigurationError
+from campfire_cli.config.defaults import effective_config
+from campfire_cli.config.settings import WorkspaceSettings, campfire_home
+
+
+@dataclass
+class AppContainer:
+    settings: WorkspaceSettings
+    maintenance: MaintenanceService
+    restructure: RestructureService
+    domain_restructure: DomainRestructureService
+    adoption: AdoptionService
+    skill: SkillService
+    base: BaseService
+    decision: DecisionService
+
+    @classmethod
+    def setup(cls, workspace: Path, make_default: bool = False) -> dict:
+        """Bootstrap one device from the portable Workspace Manifest."""
+        governance_root = campfire_home()
+        setup_result = WorkspaceService(
+            governance_root, SqliteWorkspaceRepository(governance_root)
+        ).setup(workspace, make_default)
+        container = cls.build(setup_result.workspace_id)
+        settings = container.settings
+        return {
+            **setup_result.model_dump(mode="json"),
+            "resources": {
+                "config": WorkspaceConfigService(settings).check().model_dump(mode="json"),
+                "skills": container.skill.sync(dry_run=False).model_dump(mode="json"),
+                "bases": container.base.sync(dry_run=False).model_dump(mode="json"),
+            },
+            "health": container.maintenance.check(summary=True).model_dump(mode="json"),
+        }
+
+    @classmethod
+    def build_skill(cls) -> SkillService:
+        """Build the global Skill service without requiring a registered Workspace."""
+        home = campfire_home()
+        try:
+            config = effective_config(home / "config.yml")
+        except (OSError, ValueError) as exc:
+            raise ConfigurationError(f"无法加载 Campfire config.yml：{exc}") from exc
+        settings = WorkspaceSettings(
+            workspace_id="",
+            vault_root=home,
+            state_root=home,
+            governance=config["governance"],
+            document_types=config["document_types"],
+            frontmatter_schema=config["frontmatter_schema"],
+            skills=config["skills"],
+            bases=config["bases"],
+        )
+        return SkillService(settings, SkillRepository())
+
+    @classmethod
+    def build(cls, workspace: str | Path | None) -> AppContainer:
+        governance_root = campfire_home()
+        resolution = WorkspaceService(
+            governance_root, SqliteWorkspaceRepository(governance_root)
+        ).resolve(str(workspace) if workspace is not None else None, Path.cwd())
+        settings = WorkspaceSettings.load(resolution.workspace_id, Path(resolution.workspace))
+        database_path = governance_root / "campfire.db"
+        upgrade_database(database_path)
+        engine = create_sqlite_engine(database_path)
+        session = open_session(engine)
+        maintenance_repository = SqliteMaintenanceRepository(
+            session, resolution.workspace_id, settings.state_root
+        )
+        maintenance = MaintenanceService(settings, maintenance_repository)
+        restructure_repository = SqliteRestructureRepository(
+            session, settings.state_root, resolution.workspace_id
+        )
+        restructure = RestructureService(settings, restructure_repository)
+        domain_restructure = DomainRestructureService(
+            settings, SqliteWorkspaceRepository(governance_root), maintenance
+        )
+        adoption = AdoptionService(
+            settings,
+            SqliteAdoptionRepository(session, resolution.workspace_id),
+            SqliteWorkspaceRepository(governance_root),
+            maintenance,
+        )
+        skill = SkillService(settings, SkillRepository())
+        base = BaseService(settings, BaseRepository())
+        decision = DecisionService(
+            SqliteDecisionRepository(session, resolution.workspace_id),
+            DecisionProjectionService(settings),
+        )
+        return cls(
+            settings=settings,
+            maintenance=maintenance,
+            restructure=restructure,
+            domain_restructure=domain_restructure,
+            adoption=adoption,
+            skill=skill,
+            base=base,
+            decision=decision,
+        )

campfire_cli/main.py

@@ -0,0 +1,133 @@
+from __future__ import annotations
+
+import json
+import sys
+from contextlib import suppress
+from pathlib import Path
+from typing import Any
+
+import typer
+
+from campfire_cli import __version__
+from campfire_cli.app.base.cli.base_cli import base_cli
+from campfire_cli.app.decision.cli.decision_cli import decision_cli
+from campfire_cli.app.document.cli.document_cli import document_cli
+from campfire_cli.app.maintenance.cli.maintenance_cli import maintenance_cli
+from campfire_cli.app.skill.cli.skill_cli import skill_cli
+from campfire_cli.app.skill.service.skill_service import SkillService
+from campfire_cli.app.workspace.cli.adoption_cli import adoption_cli
+from campfire_cli.app.workspace.cli.config_cli import config_cli
+from campfire_cli.app.workspace.cli.domain_cli import domain_cli
+from campfire_cli.app.workspace.cli.project_cli import project_cli
+from campfire_cli.app.workspace.cli.restructure_cli import restructure_cli
+from campfire_cli.app.workspace.cli.space_cli import space_cli
+from campfire_cli.app.workspace.cli.workspace_cli import workspace_cli
+from campfire_cli.common.exceptions import AppError
+from campfire_cli.container import AppContainer
+
+# Windows 控制台默认 GBK 代码页会把中文输出编码成 GBK 导致乱码；
+# 统一以 UTF-8 输出（测试环境的替换流没有 reconfigure，直接跳过）。
+for _stream in (sys.stdout, sys.stderr):
+    if hasattr(_stream, "reconfigure"):
+        with suppress(OSError, ValueError):
+            _stream.reconfigure(encoding="utf-8")
+
+CONTEXT_SETTINGS = {"help_option_names": ["-h", "--help"]}
+
+
+class LazyContainer:
+    """Delay Workspace discovery until a command actually requests an application service."""
+
+    def __init__(self, workspace: str | None) -> None:
+        self._workspace = workspace
+        self._container: AppContainer | None = None
+        self._skill: SkillService | None = None
+
+    def __getattr__(self, name: str) -> Any:
+        # Skill 是全局资源（同步到 ~/.claude/skills 等），不依赖任何已注册
+        # Workspace；单独构建，避免首次安装时尚未注册 Workspace 就无法使用。
+        if name == "skill":
+            if self._skill is None:
+                self._skill = AppContainer.build_skill()
+            return self._skill
+        if self._container is None:
+            try:
+                self._container = AppContainer.build(self._workspace)
+            except AppError as exc:
+                typer.echo(
+                    json.dumps({"status": "error", "message": str(exc)}, ensure_ascii=False),
+                    err=True,
+                )
+                raise typer.Exit(exc.exit_code) from exc
+        return getattr(self._container, name)
+
+
+app = typer.Typer(
+    help="人类与 Agent 共用的 Workspace 文档治理 CLI",
+    no_args_is_help=True,
+    context_settings=CONTEXT_SETTINGS,
+)
+workspace_cli.add_typer(project_cli, name="project")
+workspace_cli.add_typer(space_cli, name="space")
+workspace_cli.add_typer(domain_cli, name="domain")
+workspace_cli.add_typer(config_cli, name="config")
+workspace_cli.add_typer(restructure_cli, name="restructure")
+workspace_cli.add_typer(adoption_cli, name="adopt")
+app.add_typer(workspace_cli, name="workspace")
+app.add_typer(document_cli, name="document")
+app.add_typer(decision_cli, name="decision")
+app.add_typer(maintenance_cli, name="maintenance")
+app.add_typer(skill_cli, name="skill")
+app.add_typer(base_cli, name="base")
+
+
+@app.callback()
+def main(
+    ctx: typer.Context,
+    workspace: str | None = typer.Option(None, "--workspace", help="已注册 Workspace 的 id 或路径"),
+) -> None:
+    """初始化目标 Workspace 的应用依赖。"""
+    if ctx.invoked_subcommand in {None, "version", "setup", "workspace", "document"}:
+        return
+    ctx.obj = LazyContainer(workspace)
+
+
+@app.command("version")
+def version() -> None:
+    """显示 CLI 版本。"""
+    typer.echo(__version__)
+
+
+def render_command_tree(command: Any, name: str, prefix: str = "") -> list[str]:
+    lines = [prefix + name]
+    if not hasattr(command, "commands"):
+        return lines
+    children = list(command.commands.items())
+    for index, (child_name, child) in enumerate(children):
+        last = index == len(children) - 1
+        connector = "└── " if last else "├── "
+        child_prefix = prefix + ("    " if last else "│   ")
+        child_lines = render_command_tree(child, child_name, child_prefix)
+        child_lines[0] = prefix + connector + child_name
+        lines.extend(child_lines)
+    return lines
+
+
+@app.command("tree")
+def tree(ctx: typer.Context) -> None:
+    """显示完整 CLI 命令树，便于人类和 Agent 渐进式发现能力。"""
+    typer.echo("\n".join(render_command_tree(ctx.find_root().command, "campfire")))
+
+
+@app.command("setup")
+def setup(
+    workspace: Path = typer.Option(..., "--workspace", help="要初始化的 Workspace 根目录"),
+    make_default: bool = typer.Option(False, "--default", help="设为默认 Workspace"),
+) -> None:
+    """从 .campfire.yaml 配置本机，或为已注册 Workspace 创建首份 Manifest。"""
+    try:
+        result = AppContainer.setup(workspace, make_default)
+    except AppError as exc:
+        typer.echo(json.dumps({"status": "error", "message": str(exc)}, ensure_ascii=False))
+        raise typer.Exit(exc.exit_code) from exc
+    typer.echo(json.dumps(result, ensure_ascii=False, indent=2))

campfire_cli/resources/__init__.py

@@ -0,0 +1 @@
+"""Packaged Campfire resources."""

campfire_cli/resources/bases/Agent/346/211/247/350/241/214/345/267/245/344/275/234/345/217/260.base

@@ -0,0 +1,35 @@
+filters:
+  and:
+    - 'file.ext == "md"'
+    - 'type == "task"'
+    - 'list(assignee).contains("agent")'
+properties:
+  file.name: {displayName: 任务}
+  project: {displayName: 项目}
+  domain: {displayName: 领域}
+  lifecycle: {displayName: 状态}
+  priority: {displayName: 优先级}
+  assignee: {displayName: 执行者}
+  blocked_reason: {displayName: 阻塞原因}
+  requires_human: {displayName: 需要确认}
+  updated: {displayName: 更新时间}
+views:
+  - type: table
+    name: Agent全部任务
+    order: [file.name, project, lifecycle, priority, assignee, requires_human, updated]
+  - type: table
+    name: 执行中
+    filters: 'lifecycle == "in-progress"'
+    order: [file.name, project, priority, assignee, updated]
+  - type: table
+    name: 当前阻塞
+    filters: 'lifecycle == "blocked"'
+    order: [file.name, project, priority, assignee, blocked_reason, updated]
+  - type: table
+    name: 等待验收
+    filters: 'lifecycle == "review"'
+    order: [file.name, project, priority, assignee, updated]
+  - type: table
+    name: 最近完成
+    filters: 'lifecycle == "completed" && completed >= today() - "30d"'
+    order: [file.name, project, assignee, completed, updated]

campfire_cli/resources/bases/SPEC.md

@@ -0,0 +1,3 @@
+# Base Resources SPEC
+
+本目录是标准 Obsidian Base 的唯一事实来源。Vault `治理视图/` 中同名文件由 `campfire base sync` 生成；个性化视图应使用其他文件名。

campfire_cli/resources/bases//344/273/273/345/212/241/345/267/245/344/275/234/345/217/260.base

@@ -0,0 +1,49 @@
+filters:
+  and:
+    - 'file.ext == "md"'
+    - 'type == "task"'
+properties:
+  file.name: {displayName: 任务}
+  project: {displayName: 项目}
+  domain: {displayName: 领域}
+  task_source: {displayName: 来源}
+  lifecycle: {displayName: 状态}
+  priority: {displayName: 优先级}
+  assignee: {displayName: 执行者}
+  requires_human: {displayName: 需要确认}
+  blocked_reason: {displayName: 阻塞原因}
+  due: {displayName: 截止日期}
+  updated: {displayName: 更新时间}
+views:
+  - type: table
+    name: 全部任务
+    order: [file.name, project, lifecycle, domain, task_source, priority, assignee, requires_human, due, updated]
+    sort:
+      - property: lifecycle
+        direction: DESC
+  - type: table
+    name: 我的待确认
+    filters: 'requires_human == true && lifecycle != "completed" && lifecycle != "archived"'
+    order: [file.name, project, task_source, lifecycle, priority, blocked_reason, updated]
+  - type: table
+    name: 上级交办
+    filters: 'task_source == "assigned" && lifecycle != "completed" && lifecycle != "archived"'
+    groupBy: {property: project, direction: ASC}
+    order: [file.name, lifecycle, priority, assignee, due, updated]
+  - type: table
+    name: 个人任务
+    filters: 'task_source == "personal" && lifecycle != "completed" && lifecycle != "archived"'
+    groupBy: {property: project, direction: ASC}
+    order: [file.name, lifecycle, priority, assignee, due, updated]
+  - type: table
+    name: 当前阻塞
+    filters: 'lifecycle == "blocked"'
+    order: [file.name, project, task_source, priority, blocked_reason, updated]
+  - type: table
+    name: 等待验收
+    filters: 'lifecycle == "review"'
+    order: [file.name, project, task_source, assignee, updated]
+  - type: table
+    name: 最近完成
+    filters: 'lifecycle == "completed" && completed >= today() - "30d"'
+    order: [file.name, project, task_source, completed, updated]

campfire_cli/resources/bases//345/206/263/347/255/226/345/267/245/344/275/234/345/217/260.base

@@ -0,0 +1,40 @@
+filters:
+  and:
+    - 'file.ext == "md"'
+    - 'file.path.startsWith("_协作/decisions/")'
+    - 'object_type == "decision"'
+properties:
+  file.name: {displayName: 决策事项}
+  decision_status: {displayName: 状态}
+  source_type: {displayName: 来源}
+  answered_by: {displayName: 回答者}
+  created_at: {displayName: 创建时间}
+  updated_at: {displayName: 更新时间}
+  answered_at: {displayName: 回答时间}
+  closed_at: {displayName: 关闭时间}
+views:
+  - type: table
+    name: 待我确认
+    filters: 'decision_status == "pending"'
+    order: [file.name, source_type, decision_status, created_at, updated_at]
+    sort:
+      - property: updated_at
+        direction: DESC
+  - type: table
+    name: 已回答待消费
+    filters: 'decision_status == "answered"'
+    order: [file.name, source_type, answered_by, answered_at, updated_at]
+  - type: table
+    name: 已关闭
+    filters: 'decision_status == "closed"'
+    order: [file.name, source_type, answered_by, closed_at]
+  - type: table
+    name: 已取消
+    filters: 'decision_status == "cancelled"'
+    order: [file.name, source_type, closed_at]
+  - type: table
+    name: 全部决策
+    order: [file.name, decision_status, source_type, answered_by, created_at, answered_at, closed_at]
+    sort:
+      - property: updated_at
+        direction: DESC

campfire_cli/resources/bases//345/276/205/345/275/222/346/241/243/346/226/207/346/241/243.base

@@ -0,0 +1,28 @@
+filters:
+  and:
+    - 'file.ext == "md"'
+    - 'archive_requested == true'
+properties:
+  file.name: {displayName: 文档}
+  project: {displayName: 项目}
+  domain: {displayName: 领域}
+  type: {displayName: 类型}
+  archive_reason: {displayName: 归档原因}
+  superseded_by: {displayName: 替代文档}
+  updated: {displayName: 更新时间}
+views:
+  - type: table
+    name: 全部待归档
+    order: [file.name, project, domain, type, archive_reason, superseded_by, updated]
+  - type: table
+    name: 缺少归档原因
+    filters: archive_reason.isEmpty()
+    order: [file.name, project, domain, type, updated]
+  - type: table
+    name: 缺少替代文档
+    filters: '(archive_reason == "superseded" || archive_reason == "merged") && superseded_by.isEmpty()'
+    order: [file.name, project, domain, archive_reason, superseded_by, updated]
+  - type: table
+    name: 可执行候选
+    filters: '!archive_reason.isEmpty() && !((archive_reason == "superseded" || archive_reason == "merged") && superseded_by.isEmpty())'
+    order: [file.name, project, domain, type, archive_reason, superseded_by, updated]

campfire_cli/resources/bases//351/241/271/347/233/256/346/226/207/346/241/243.base

@@ -0,0 +1,35 @@
+filters:
+  and:
+    - 'file.ext == "md"'
+    - '!project.isEmpty()'
+    - '!file.path.contains("/archive/")'
+properties:
+  file.name: {displayName: 文档}
+  project: {displayName: 项目}
+  domain: {displayName: 领域}
+  type: {displayName: 类型}
+  status: {displayName: 状态}
+  lifecycle: {displayName: 生命周期}
+  updated: {displayName: 更新时间}
+views:
+  - type: table
+    name: 全部项目文档
+    groupBy: {property: project, direction: ASC}
+    order: [file.name, project, domain, type, status, lifecycle, updated]
+  - type: table
+    name: 当前权威文档
+    filters: 'status == "current"'
+    groupBy: {property: project, direction: ASC}
+    order: [file.name, project, domain, type, lifecycle, updated]
+  - type: table
+    name: 草稿与提案
+    filters: 'status == "draft" || lifecycle == "proposed"'
+    order: [file.name, project, domain, type, status, lifecycle, updated]
+  - type: table
+    name: 进行中计划
+    filters: 'type == "plan" && lifecycle != "archived"'
+    order: [file.name, project, domain, status, lifecycle, updated]
+  - type: table
+    name: 未关闭问题
+    filters: 'type == "issue" && lifecycle != "archived"'
+    order: [file.name, project, domain, status, lifecycle, updated]

campfire_cli/resources/defaults/__init__.py

@@ -0,0 +1 @@
+"""Packaged Campfire product defaults."""