campfire-cli 0.1.0__py3-none-any.whl

campfire_cli/__init__.py

@@ -0,0 +1,3 @@
+"""Campfire CLI package."""
+
+__version__ = "0.1.0"

campfire_cli/alembic/__init__.py

@@ -0,0 +1 @@
+"""Packaged Alembic migration environment."""

campfire_cli/alembic/env.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+from sqlalchemy import engine_from_config, pool
+
+from alembic import context
+from campfire_cli.common.database.models import Base
+
+config = context.config
+target_metadata = Base.metadata
+
+
+def run_migrations_offline() -> None:
+    context.configure(
+        url=config.get_main_option("sqlalchemy.url"),
+        target_metadata=target_metadata,
+        literal_binds=True,
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    connectable = engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata)
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

campfire_cli/alembic/script.py.mako

@@ -0,0 +1,22 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+"""
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+revision = ${repr(up_revision)}
+down_revision = ${repr(down_revision)}
+branch_labels = ${repr(branch_labels)}
+depends_on = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}

campfire_cli/alembic/versions/001_initial_schema.py

@@ -0,0 +1,81 @@
+"""Create Campfire state tables."""
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision = "001"
+down_revision = None
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "documents",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column("path", sa.Text(), nullable=False),
+        sa.Column("content_hash", sa.String(64), nullable=False),
+        sa.Column("document_type", sa.String(64)),
+        sa.Column("domain_id", sa.String(128)),
+        sa.Column("status", sa.String(32)),
+        sa.Column("exists", sa.Boolean(), nullable=False),
+        sa.Column("indexed_at", sa.DateTime(), nullable=False),
+        sa.UniqueConstraint("path"),
+    )
+    op.create_index("ix_documents_path", "documents", ["path"])
+    op.create_table(
+        "governance_issues",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column("path", sa.Text(), nullable=False),
+        sa.Column("code", sa.String(96), nullable=False),
+        sa.Column("detail", sa.Text(), nullable=False),
+        sa.Column("severity", sa.String(16), nullable=False),
+        sa.Column("status", sa.String(16), nullable=False),
+        sa.UniqueConstraint("path", "code", "detail"),
+    )
+    op.create_index("ix_governance_issues_code", "governance_issues", ["code"])
+    op.create_table(
+        "maintenance_runs",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column("run_id", sa.String(36), nullable=False, unique=True),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("scanned_count", sa.Integer(), nullable=False),
+        sa.Column("issue_count", sa.Integer(), nullable=False),
+        sa.Column("started_at", sa.DateTime(), nullable=False),
+        sa.Column("finished_at", sa.DateTime()),
+    )
+    op.create_table(
+        "migration_batches",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column("batch_uuid", sa.String(36), nullable=False, unique=True),
+        sa.Column("batch_name", sa.String(128), nullable=False, unique=True),
+        sa.Column("scope", sa.Text(), nullable=False),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("config_hash", sa.String(64), nullable=False),
+        sa.Column("created_at", sa.DateTime(), nullable=False),
+    )
+    op.create_table(
+        "migration_items",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column("batch_id", sa.Integer(), sa.ForeignKey("migration_batches.id"), nullable=False),
+        sa.Column("item_uuid", sa.String(36), nullable=False, unique=True),
+        sa.Column("source_path", sa.Text(), nullable=False),
+        sa.Column("target_path", sa.Text(), nullable=False),
+        sa.Column("source_hash", sa.String(64), nullable=False),
+        sa.Column("action", sa.String(32), nullable=False),
+        sa.Column("proposed_type", sa.String(64)),
+        sa.Column("reason", sa.Text(), nullable=False),
+        sa.Column("confidence", sa.String(16), nullable=False),
+        sa.Column("approved", sa.Boolean(), nullable=False),
+        sa.Column("execution_status", sa.String(24), nullable=False),
+    )
+    op.create_index("ix_migration_items_batch_id", "migration_items", ["batch_id"])
+
+
+def downgrade() -> None:
+    op.drop_table("migration_items")
+    op.drop_table("migration_batches")
+    op.drop_table("maintenance_runs")
+    op.drop_table("governance_issues")
+    op.drop_table("documents")

campfire_cli/alembic/versions/002_workspace_project_registry.py

@@ -0,0 +1,47 @@
+"""Create the SQLite-backed Workspace and Project registry."""
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision = "002"
+down_revision = "001"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "workspaces",
+        sa.Column("id", sa.String(63), primary_key=True),
+        sa.Column("path", sa.Text(), nullable=False, unique=True),
+        sa.Column("is_default", sa.Boolean(), nullable=False),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("created_at", sa.DateTime(), nullable=False),
+        sa.Column("updated_at", sa.DateTime(), nullable=False),
+    )
+    op.create_index("ix_workspaces_is_default", "workspaces", ["is_default"])
+    op.create_table(
+        "projects",
+        sa.Column("id", sa.String(63), primary_key=True),
+        sa.Column(
+            "workspace_id",
+            sa.String(63),
+            sa.ForeignKey("workspaces.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("name", sa.String(160), nullable=False),
+        sa.Column("document_domain", sa.Text(), nullable=False),
+        sa.Column("git_remote_url", sa.Text()),
+        sa.Column("local_path", sa.Text()),
+        sa.Column("default_branch", sa.String(160)),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("created_at", sa.DateTime(), nullable=False),
+        sa.Column("updated_at", sa.DateTime(), nullable=False),
+    )
+    op.create_index("ix_projects_workspace_id", "projects", ["workspace_id"])
+
+
+def downgrade() -> None:
+    op.drop_table("projects")
+    op.drop_table("workspaces")

campfire_cli/alembic/versions/003_unified_workspace_state.py

@@ -0,0 +1,113 @@
+"""Move all operational state into the workspace-scoped global database."""
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision = "003"
+down_revision = "002"
+branch_labels = None
+depends_on = None
+
+
+def workspace_column() -> sa.Column:
+    return sa.Column(
+        "workspace_id",
+        sa.String(63),
+        sa.ForeignKey("workspaces.id", ondelete="CASCADE"),
+        nullable=False,
+    )
+
+
+def upgrade() -> None:
+    # Versions before 0.9 never wrote operational state to the global database.
+    # Recreate these empty legacy tables with explicit Workspace ownership.
+    for table in (
+        "migration_items",
+        "migration_batches",
+        "maintenance_runs",
+        "governance_issues",
+        "documents",
+    ):
+        op.drop_table(table)
+
+    op.create_table(
+        "documents",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        workspace_column(),
+        sa.Column("path", sa.Text(), nullable=False),
+        sa.Column("content_hash", sa.String(64), nullable=False),
+        sa.Column("document_type", sa.String(64)),
+        sa.Column("domain_id", sa.String(128)),
+        sa.Column("status", sa.String(32)),
+        sa.Column("exists", sa.Boolean(), nullable=False),
+        sa.Column("indexed_at", sa.DateTime(), nullable=False),
+        sa.UniqueConstraint("workspace_id", "path"),
+    )
+    op.create_index("ix_documents_workspace_id", "documents", ["workspace_id"])
+    op.create_index("ix_documents_path", "documents", ["path"])
+    op.create_table(
+        "governance_issues",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        workspace_column(),
+        sa.Column("path", sa.Text(), nullable=False),
+        sa.Column("code", sa.String(96), nullable=False),
+        sa.Column("detail", sa.Text(), nullable=False),
+        sa.Column("severity", sa.String(16), nullable=False),
+        sa.Column("status", sa.String(16), nullable=False),
+        sa.UniqueConstraint("workspace_id", "path", "code", "detail"),
+    )
+    op.create_index("ix_governance_issues_workspace_id", "governance_issues", ["workspace_id"])
+    op.create_index("ix_governance_issues_code", "governance_issues", ["code"])
+    op.create_table(
+        "maintenance_runs",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        workspace_column(),
+        sa.Column("run_id", sa.String(36), nullable=False, unique=True),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("scanned_count", sa.Integer(), nullable=False),
+        sa.Column("issue_count", sa.Integer(), nullable=False),
+        sa.Column("started_at", sa.DateTime(), nullable=False),
+        sa.Column("finished_at", sa.DateTime()),
+    )
+    op.create_index("ix_maintenance_runs_workspace_id", "maintenance_runs", ["workspace_id"])
+    op.create_table(
+        "migration_batches",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        workspace_column(),
+        sa.Column("batch_uuid", sa.String(36), nullable=False, unique=True),
+        sa.Column("batch_name", sa.String(128), nullable=False),
+        sa.Column("scope", sa.Text(), nullable=False),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("config_hash", sa.String(64), nullable=False),
+        sa.Column("created_at", sa.DateTime(), nullable=False),
+        sa.UniqueConstraint("workspace_id", "batch_name"),
+    )
+    op.create_index("ix_migration_batches_workspace_id", "migration_batches", ["workspace_id"])
+    op.create_table(
+        "migration_items",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        workspace_column(),
+        sa.Column(
+            "batch_id",
+            sa.Integer(),
+            sa.ForeignKey("migration_batches.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("item_uuid", sa.String(36), nullable=False, unique=True),
+        sa.Column("source_path", sa.Text(), nullable=False),
+        sa.Column("target_path", sa.Text(), nullable=False),
+        sa.Column("source_hash", sa.String(64), nullable=False),
+        sa.Column("action", sa.String(32), nullable=False),
+        sa.Column("proposed_type", sa.String(64)),
+        sa.Column("reason", sa.Text(), nullable=False),
+        sa.Column("confidence", sa.String(16), nullable=False),
+        sa.Column("approved", sa.Boolean(), nullable=False),
+        sa.Column("execution_status", sa.String(24), nullable=False),
+    )
+    op.create_index("ix_migration_items_workspace_id", "migration_items", ["workspace_id"])
+    op.create_index("ix_migration_items_batch_id", "migration_items", ["batch_id"])
+
+
+def downgrade() -> None:
+    raise RuntimeError("The unified database migration is intentionally irreversible")

campfire_cli/alembic/versions/004_restructure_workspace_domain.py

@@ -0,0 +1,23 @@
+"""Rename the former migration persistence model to Workspace restructure."""
+
+from alembic import op
+
+revision = "004"
+down_revision = "003"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.rename_table("migration_batches", "restructure_batches")
+    op.rename_table("migration_items", "restructure_items")
+    op.drop_index("ix_migration_batches_workspace_id", table_name="restructure_batches")
+    op.drop_index("ix_migration_items_workspace_id", table_name="restructure_items")
+    op.drop_index("ix_migration_items_batch_id", table_name="restructure_items")
+    op.create_index("ix_restructure_batches_workspace_id", "restructure_batches", ["workspace_id"])
+    op.create_index("ix_restructure_items_workspace_id", "restructure_items", ["workspace_id"])
+    op.create_index("ix_restructure_items_batch_id", "restructure_items", ["batch_id"])
+
+
+def downgrade() -> None:
+    raise RuntimeError("The Workspace restructure rename is intentionally irreversible")

campfire_cli/alembic/versions/005_decision_channel.py

@@ -0,0 +1,71 @@
+"""Add persistent Decision state and append-only events."""
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision = "005"
+down_revision = "004"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "decisions",
+        sa.Column("id", sa.String(36), primary_key=True),
+        sa.Column(
+            "workspace_id",
+            sa.String(63),
+            sa.ForeignKey("workspaces.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("dedupe_key", sa.String(160), nullable=False),
+        sa.Column("question", sa.Text(), nullable=False),
+        sa.Column("context", sa.Text(), nullable=False),
+        sa.Column("recommendation", sa.Text(), nullable=False),
+        sa.Column("options_json", sa.Text(), nullable=False),
+        sa.Column("related_documents_json", sa.Text(), nullable=False),
+        sa.Column("source_type", sa.String(64), nullable=False),
+        sa.Column("source_id", sa.String(160)),
+        sa.Column("session_provider", sa.String(64)),
+        sa.Column("session_id", sa.String(200)),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("answer", sa.Text()),
+        sa.Column("answered_by", sa.String(160)),
+        sa.Column("cancellation_reason", sa.Text()),
+        sa.Column("created_at", sa.DateTime(), nullable=False),
+        sa.Column("updated_at", sa.DateTime(), nullable=False),
+        sa.Column("answered_at", sa.DateTime()),
+        sa.Column("closed_at", sa.DateTime()),
+        sa.UniqueConstraint("workspace_id", "dedupe_key"),
+    )
+    op.create_index("ix_decisions_workspace_id", "decisions", ["workspace_id"])
+    op.create_index("ix_decisions_status", "decisions", ["status"])
+    op.create_table(
+        "decision_events",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column(
+            "workspace_id",
+            sa.String(63),
+            sa.ForeignKey("workspaces.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column(
+            "decision_id",
+            sa.String(36),
+            sa.ForeignKey("decisions.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("event_type", sa.String(64), nullable=False),
+        sa.Column("actor", sa.String(160)),
+        sa.Column("payload_json", sa.Text(), nullable=False),
+        sa.Column("created_at", sa.DateTime(), nullable=False),
+    )
+    op.create_index("ix_decision_events_workspace_id", "decision_events", ["workspace_id"])
+    op.create_index("ix_decision_events_decision_id", "decision_events", ["decision_id"])
+    op.create_index("ix_decision_events_event_type", "decision_events", ["event_type"])
+
+
+def downgrade() -> None:
+    raise RuntimeError("Decision history is intentionally irreversible")

campfire_cli/alembic/versions/006_workspace_topology_index.py

@@ -0,0 +1,61 @@
+"""Add rebuildable Space and Domain topology indexes."""
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision = "006"
+down_revision = "005"
+branch_labels = None
+depends_on = None
+
+
+def workspace_column() -> sa.Column:
+    return sa.Column(
+        "workspace_id",
+        sa.String(63),
+        sa.ForeignKey("workspaces.id", ondelete="CASCADE"),
+        nullable=False,
+    )
+
+
+def upgrade() -> None:
+    op.create_table(
+        "spaces",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        workspace_column(),
+        sa.Column("space_id", sa.String(128), nullable=False),
+        sa.Column("name", sa.String(160), nullable=False),
+        sa.Column("path", sa.Text(), nullable=False),
+        sa.Column("space_type", sa.String(64), nullable=False),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("source_hash", sa.String(64), nullable=False),
+        sa.Column("indexed_at", sa.DateTime(), nullable=False),
+        sa.UniqueConstraint("workspace_id", "space_id"),
+    )
+    op.create_index("ix_spaces_workspace_id", "spaces", ["workspace_id"])
+    op.create_table(
+        "domains",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        workspace_column(),
+        sa.Column("domain_id", sa.String(128), nullable=False),
+        sa.Column("space_id", sa.String(128), nullable=False),
+        sa.Column("parent_domain_id", sa.String(128)),
+        sa.Column("project_id", sa.String(63)),
+        sa.Column("name", sa.String(160), nullable=False),
+        sa.Column("path", sa.Text(), nullable=False),
+        sa.Column("domain_type", sa.String(64), nullable=False),
+        sa.Column("governance", sa.String(64), nullable=False),
+        sa.Column("moc", sa.Text(), nullable=False),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("source_hash", sa.String(64), nullable=False),
+        sa.Column("indexed_at", sa.DateTime(), nullable=False),
+        sa.UniqueConstraint("workspace_id", "domain_id"),
+    )
+    op.create_index("ix_domains_workspace_id", "domains", ["workspace_id"])
+    op.create_index("ix_domains_space_id", "domains", ["space_id"])
+
+
+def downgrade() -> None:
+    op.drop_table("domains")
+    op.drop_table("spaces")

campfire_cli/alembic/versions/007_workspace_adoption.py

@@ -0,0 +1,38 @@
+"""Add Workspace folder adoption batches."""
+
+import sqlalchemy as sa
+
+from alembic import op
+
+revision = "007"
+down_revision = "006"
+branch_labels = None
+depends_on = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "adoption_batches",
+        sa.Column("id", sa.Integer(), primary_key=True),
+        sa.Column(
+            "workspace_id",
+            sa.String(63),
+            sa.ForeignKey("workspaces.id", ondelete="CASCADE"),
+            nullable=False,
+        ),
+        sa.Column("batch_name", sa.String(128), nullable=False),
+        sa.Column("source_path", sa.Text(), nullable=False),
+        sa.Column("source_kind", sa.String(16), nullable=False),
+        sa.Column("staging_path", sa.Text()),
+        sa.Column("status", sa.String(24), nullable=False),
+        sa.Column("inventory_json", sa.Text(), nullable=False),
+        sa.Column("plan_json", sa.Text()),
+        sa.Column("created_at", sa.DateTime(), nullable=False),
+        sa.Column("updated_at", sa.DateTime(), nullable=False),
+        sa.UniqueConstraint("workspace_id", "batch_name"),
+    )
+    op.create_index("ix_adoption_batches_workspace_id", "adoption_batches", ["workspace_id"])
+
+
+def downgrade() -> None:
+    op.drop_table("adoption_batches")

campfire_cli/alembic/versions/__init__.py

@@ -0,0 +1 @@
+"""Campfire database revisions."""

campfire_cli/app/SPEC.md

@@ -0,0 +1,12 @@
+# App SPEC
+
+业务模块采用 `CLI → Service → Protocol ← Implementation` 单向依赖。CLI 只解析参数、选择输出格式并翻译异常；Service 实现用例；Protocol 由消费方定义；Repository 负责 SQLite 或文件持久化，不作语义判断。
+
+当前模块：
+
+- `document/`：文档自身、文档规则以及面向用户和 Agent 的文档命令。
+- `decision/`：需要人类或高级 Agent 回答的持久判断、状态机、事件历史和只读 Vault 投影。
+- `maintenance/`：新增与变更文档的持续维护，归档属于其用例。
+- `workspace/`：注册、初始化、解析和选择多个 Workspace，并通过扁平的 Restructure Service 执行一次性、大规模、批次化结构重构。
+- `skill/`：Campfire SOP Skill 的发现、加载、校验和同步。
+- `base/`：Obsidian Base 标准治理视图。

campfire_cli/app/__init__.py

@@ -0,0 +1 @@
+"""Campfire business modules."""

campfire_cli/app/base/SPEC.md

@@ -0,0 +1,3 @@
+# Base App SPEC
+
+管理包内 SSOT Obsidian Base 与 Vault `治理视图/` 的确定性同步。只管理配置声明的 Base，不修改 Markdown，不删除未知或孤立 Base。

campfire_cli/app/base/__init__.py

@@ -0,0 +1 @@
+"""Obsidian Base management application module."""

campfire_cli/app/base/cli/base_cli.py

@@ -0,0 +1,37 @@
+from __future__ import annotations
+
+import json
+
+import typer
+
+base_cli = typer.Typer(
+    help="管理 Obsidian Base 标准治理视图", context_settings={"help_option_names": ["-h", "--help"]}
+)
+
+
+def emit(result: object) -> None:
+    typer.echo(json.dumps(result.model_dump(mode="json"), ensure_ascii=False, indent=2))
+
+
+@base_cli.command("list")
+def list_bases(ctx: typer.Context) -> None:
+    """列出包内 SSOT Base 及 Vault 同步状态。"""
+    emit(ctx.obj.base.list())
+
+
+@base_cli.command("show")
+def show(ctx: typer.Context, name: str, source: str = typer.Option("ssot", "--source")) -> None:
+    """读取一个 Base；source 可选 ssot 或 vault。"""
+    emit(ctx.obj.base.show(name, source))
+
+
+@base_cli.command("check")
+def check(ctx: typer.Context) -> None:
+    """只读检查 Base 配置、YAML 和同步状态。"""
+    emit(ctx.obj.base.check())
+
+
+@base_cli.command("sync")
+def sync(ctx: typer.Context, dry_run: bool = typer.Option(False, "--dry-run")) -> None:
+    """将托管 Base 从包内 SSOT 确定性同步到 Vault。"""
+    emit(ctx.obj.base.sync(dry_run))

campfire_cli/app/base/repository/base_repository.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from importlib.resources import files
+from pathlib import Path
+
+from campfire_cli.common.filesystem import atomic_write
+
+
+class BaseRepository:
+    def source_root(self) -> Path:
+        return Path(str(files("campfire_cli.resources") / "bases"))
+
+    def read(self, path: Path) -> str:
+        return path.read_text(encoding="utf-8")
+
+    def write(self, path: Path, content: str) -> None:
+        atomic_write(path, content)

campfire_cli/app/base/schema/base_schema.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from pydantic import BaseModel, Field
+
+
+class BaseInfo(BaseModel):
+    name: str
+    path: str
+    status: str
+    views: list[str] = Field(default_factory=list)
+
+
+class BaseResult(BaseModel):
+    status: str
+    bases: list[BaseInfo] = Field(default_factory=list)
+    operations: list[dict[str, str]] = Field(default_factory=list)
+    issues: list[dict[str, str]] = Field(default_factory=list)
+    content: str | None = None