monoco-toolkit 0.3.10__tar.gz → 0.3.12__tar.gz

monoco_toolkit-0.3.12/.agent/workflows/archaeology.md

@@ -0,0 +1,40 @@
+---
+description: 执行深度项目考古，追溯历史进展与架构演进。
+---
+
+# 项目考古工作流 (Project Archaeology)
+
+该工作流用于在特定时间跨度内重构项目历史、识别关键里程碑并分析代码演化。由于涉及大规模的文件读取和日志分析，默认使用具有超大上下文窗口的 Gemini。
+
+## 1. 配置参数
+- **开始日期 (START_DATE)**: 调查起始时间 (例如: 2026-01-26)。
+- **结束日期 (END_DATE)**: 调查截止时间 (例如: 2026-01-30)。
+- **调查深度**: 建议读取 50-100 份以上相关文档。
+
+## 2. 调度方式 (Dispatch)
+
+使用以下标准指令调度考古智能体（Agent）：
+
+// turbo
+```bash
+gemini -y -p "执行深度项目考古任务。
+调查周期：从 {START_DATE} 到 {END_DATE}。
+任务要求：
+1. 深入分析 git log 和 git diff，确定该周期内的主要变更。
+2. 广泛阅读受影响的文件及其上下文（目标 100 份文档）。
+3. 识别并分类核心进展：Feature（功能实现）、Chore（工程维护）、Fix（缺陷修复）。
+4. 分析关键的架构演进特征和决策点。
+5. 生成深度调查报告（要求中文，5000-8000字以上）。
+6. 报告路径：Archaeology/REPORT_{START_DATE}_{END_DATE}.md"
+```
+
+## 3. 约定与规范
+- **分支规范**: 🛑 **禁止**使用 Feature 分支进行考古。所有考古报告应直接在主协作分支 (main) 上进行，以避免隔离导致的历史回溯偏差。
+- **存储目录**: 所有报告必须存放在 `Archaeology/` 目录下。
+- **命名规范**: `REPORT_YYYY_MM_DD_YYYY_MM_DD.md`。
+- **报告结构**:
+  - 执行摘要 (Executive Summary)
+  - 关键事件时间线 (Timeline)
+  - 核心模块演进分析 (Detailed Analysis)
+  - 遗留问题与技术债 (Technical Debt)
+  - 架构决策点分析 (ADR-like insights)

monoco_toolkit-0.3.12/.gitignore

@@ -0,0 +1,69 @@
+# System Files
+.DS_Store
+Thumbs.db
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+# lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Python Virtual Environment
+.venv/
+venv/
+ENV/
+
+# Pytest
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.next/
+out/
+build/
+**/.vitepress/cache/
+
+# Project Specific
+MemoryDaemon/
+.reference/
+.references/
+test.pdf
+.env
+.monoco/local_config.yaml
+.monoco/sessions/
+
+# Agent Directories
+.qwen/
+.gemini/
+.claude/
+.agent/
+!.agent/workflows/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+.archives/

monoco_toolkit-0.3.12/.monoco/project.yaml

@@ -0,0 +1,24 @@
+agent:
+  providers:
+    research: gemini
+project:
+  key: TOO
+  name: Monoco Toolkit
+  spike_repos:
+    MinerU: https://github.com/opendatalab/MinerU
+    SWE-agent: https://github.com/SWE-agent/SWE-agent
+    SWE-bench: https://github.com/SWE-bench/SWE-bench
+    Typedown: https://github.com/IndenScale/Typedown
+    agent-client-protocol: https://github.com/agentclientprotocol/agent-client-protocol
+    agentskills: https://github.com/agentskills/agentskills
+    claude-agent-sdk-python: https://github.com/anthropics/claude-agent-sdk-python
+    claude-code: https://github.com/anthropics/claude-code
+    gemini-cli: https://github.com/google-gemini/gemini-cli
+    kimi-agent-sdk: https://github.com/MoonshotAI/kimi-agent-sdk
+    monoco-toolkit: https://github.com/IndenScale/monoco-toolkit
+    qwen-code: https://github.com/QwenLM/qwen-code
+    ralph: https://github.com/snarktank/ralph
+    refly: https://github.com/refly-ai/refly
+    refly-skills: https://github.com/refly-ai/refly-skills
+    skills: https://github.com/anthropics/skills
+    vibe-kanban: https://github.com/BloopAI/vibe-kanban

monoco_toolkit-0.3.12/.monoco/workspace.yaml

@@ -0,0 +1,196 @@
+agent:
+  timeout_seconds: 900
+domains:
+  items:
+  - description: DevOps and CI/CD infrastructure
+    name: backend.devops
+  - description: Containerization technologies (Docker, K8s)
+    name: infrastructure.container
+  - description: Monoco core logic
+    name: monoco.core
+  - description: Monoco CLI interface
+    name: monoco.cli
+  - description: Artificial Intelligence and Agent capabilities
+    name: intelligence
+  strict: false
+hooks:
+  hooks:
+    post-checkout: true
+    pre-push: true
+i18n:
+  source_lang: zh
+  target_langs:
+  - en
+issue:
+  solutions:
+  - implemented
+  - cancelled
+  - wontfix
+  - duplicate
+  stages:
+  - draft
+  - doing
+  - review
+  - done
+  - freezed
+  statuses:
+  - open
+  - closed
+  - backlog
+  types:
+  - description: Large strategic initiative
+    folder: Epics
+    label: Epic
+    name: epic
+    prefix: EPIC
+  - description: Value delivery atom
+    folder: Features
+    label: Feature
+    name: feature
+    prefix: FEAT
+  - description: Engineering maintenance task
+    folder: Chores
+    label: Chore
+    name: chore
+    prefix: CHORE
+  - description: Defect resolution
+    folder: Fixes
+    label: Bug Fix
+    name: fix
+    prefix: FIX
+  - description: User-centric requirement
+    folder: Stories
+    label: User Story
+    name: story
+    prefix: STORY
+  - description: Architecture Decision Record (ADR)
+    folder: Arch
+    label: Architecture Decision
+    name: arch
+    prefix: ARCH
+  workflows:
+  - command_template: monoco agent run investigate
+    description: Run agent investigation
+    icon: $(telescope)
+    label: Investigate
+    name: investigate
+    to_status: open
+  - command_template: monoco issue start {id}
+    description: Start working on the issue
+    from_stage: draft
+    from_status: open
+    icon: $(play)
+    label: Start
+    name: start
+    post_actions:
+    - monoco agent run --role engineer --issue {id} -d
+    to_stage: doing
+    to_status: open
+  - command_template: monoco agent run develop
+    description: Run agent development
+    from_stage: doing
+    from_status: open
+    icon: $(tools)
+    label: Develop
+    name: develop
+    to_stage: doing
+    to_status: open
+  - command_template: monoco issue stop {id}
+    description: Stop working and return to draft
+    from_stage: doing
+    from_status: open
+    icon: $(stop)
+    label: Stop
+    name: stop
+    to_stage: draft
+    to_status: open
+  - command_template: monoco issue submit {id}
+    description: Submit for review
+    from_stage: doing
+    from_status: open
+    icon: $(check)
+    label: Submit
+    name: submit
+    post_actions:
+    - monoco agent run --role reviewer --issue {id} -d
+    to_stage: review
+    to_status: open
+  - command_template: monoco issue update {id} --stage doing
+    description: Reject review and return to doing
+    from_stage: review
+    from_status: open
+    icon: $(error)
+    label: Reject
+    name: reject
+    to_stage: doing
+    to_status: open
+  - command_template: monoco issue close {id} --solution implemented
+    description: Accept and close issue
+    from_stage: review
+    from_status: open
+    icon: $(pass-filled)
+    label: Accept
+    name: accept
+    required_solution: implemented
+    to_stage: done
+    to_status: closed
+  - command_template: monoco issue close {id} --solution implemented
+    description: Close completed issue
+    from_stage: done
+    from_status: open
+    icon: $(close)
+    label: Close
+    name: close_done
+    required_solution: implemented
+    to_stage: done
+    to_status: closed
+  - command_template: monoco issue cancel {id}
+    description: Cancel the issue
+    from_status: open
+    icon: $(trash)
+    label: Cancel
+    name: cancel
+    required_solution: cancelled
+    to_stage: done
+    to_status: closed
+  - command_template: monoco issue close {id} --solution wontfix
+    description: Mark as won't fix
+    from_status: open
+    icon: $(circle-slash)
+    label: Won't Fix
+    name: wontfix
+    required_solution: wontfix
+    to_stage: done
+    to_status: closed
+  - command_template: monoco issue backlog pull {id}
+    description: Restore issue from backlog
+    from_status: backlog
+    icon: $(arrow-up)
+    label: Pull
+    name: pull
+    to_stage: draft
+    to_status: open
+  - command_template: monoco issue cancel {id}
+    description: Cancel backlog issue
+    from_status: backlog
+    icon: $(trash)
+    label: Cancel
+    name: cancel_backlog
+    required_solution: cancelled
+    to_stage: done
+    to_status: closed
+  - command_template: monoco issue open {id}
+    description: Reopen a closed issue
+    from_status: closed
+    icon: $(refresh)
+    label: Reopen
+    name: reopen
+    to_stage: draft
+    to_status: open
+session_hooks:
+  git_cleanup:
+    auto_delete_merged_branches: false
+    auto_switch_to_main: true
+    enabled: true
+telemetry:
+  enabled: null

monoco_toolkit-0.3.12/.pre-commit-config.yaml

@@ -0,0 +1,70 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-added-large-files
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.13
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: local
+    hooks:
+      # --- Pre-commit Hooks ---
+      - id: monoco-issue-lint
+        name: Monoco Issue Lint
+        entry: monoco issue lint
+        language: system
+        types: [markdown]
+        files: ^Issues/.*\.md$
+        pass_filenames: false
+
+      # --- Pre-push Hooks ---
+      - id: pytest
+        name: Python Tests
+        entry: uv run pytest
+        language: system
+        stages: [pre-commit, pre-push]
+        pass_filenames: false
+        # Run only if python files changed (optional optimization, but CI runs always)
+        # keeping always_run true for safety as logic might depend on non-py files
+        always_run: true
+
+      - id: vscode-compile
+        name: VS Code Extension Compile
+        entry: bash -c "cd extensions/vscode && npm run compile"
+        language: system
+        stages: [pre-push]
+        files: ^extensions/vscode/
+        pass_filenames: false
+
+      - id: vscode-lint
+        name: VS Code Extension Lint
+        entry: bash -c "cd extensions/vscode && npm run lint"
+        language: system
+        stages: [pre-push]
+        files: ^extensions/vscode/
+        pass_filenames: false
+
+      - id: vitepress-build
+        name: VitePress Site Build
+        entry: bash -c "cd site && export CI=true && npm install --silent && npm run build"
+        language: system
+        stages: [pre-push]
+        files: ^site/
+        pass_filenames: false
+
+      - id: verify-versions
+        name: Verify Version Consistency
+        entry: python scripts/verify_versions.py
+        language: system
+        stages: [pre-push]
+        pass_filenames: false
+        always_run: true