hermes-task-framework 1.2.0__tar.gz → 1.2.1__tar.gz

{hermes_task_framework-1.2.0 → hermes_task_framework-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hermes-task-framework
-Version: 1.2.0
+Version: 1.2.1
 Summary: Structured task management skills for Hermes Agent — task creation, decomposition, stage gates
 Project-URL: Source, https://github.com/nuffin/hermes-task-framework-pip
 Requires-Python: >=3.11

{hermes_task_framework-1.2.0 → hermes_task_framework-1.2.1}/hermes_task_framework/skills/task-framework/SKILL.md

@@ -33,7 +33,7 @@ tags:
 - operations
 - logging
 - pdf
-version: 1.1.0
+version: 1.2.1
 ---
 
 ---
@@ -134,11 +134,11 @@ This skill uses environment variables for portability across machines. After ins
 source ~/.hermes/env.sh
 ```
 
-If the variable is unset, fall back to `~/.hermes/tasks` (the historical default).
+Root resolution order is: `HERMES_TASKS_ROOT`, `HERMES_TASKS_DIR` compatibility alias, active-profile `tasks.data_dir`, global `tasks.data_dir`, then `~/studio/hermes/tasks`. The historical `~/.hermes/tasks` directory is compatibility-only: never create, mirror, populate, or symlink task directories there. When a custom `tasks.data_dir` is configured, it is the only task root used.
 
 ## Task Directory Structure
 
-The canonical tasks root is defined by `$HERMES_TASKS_ROOT` (default: `~/.hermes/tasks/`). All relative paths (e.g. `tasks/YYYYMMDD-*`) in documentation are relative to this root. When the user says "tasks" without qualification, this directory is the default reference — not the abstract concept of "任务". "创建一个任务" means creating a `YYYYMMDD-HHMMSS.<name>-<hash6>/` structure here using this skill.
+The canonical tasks root is defined by `$HERMES_TASKS_ROOT` or configuration (default: `~/studio/hermes/tasks/`). All relative paths (e.g. `tasks/YYYYMMDD-*`) in documentation are relative to this root. When the user says "tasks" without qualification, this directory is the default reference — not the abstract concept of "任务". "创建一个任务" means creating a `YYYYMMDD-HHMMSS.<name>-<hash6>/` structure here using this skill. Task directories must be real directories; do not create task-root or task-directory symlinks.
 
 🔴 **Semantic disambiguation (important):** When the user says "任务" or "task", first determine whether they mean (a) a task-framework managed task (in `tasks/YY.../` directories) or (b) a generic concept. Clues: specific name/timestamp, operating on a task directory → (a); abstract discussion → (b). For (a), always use task-framework tools (task_create, task_set_status, etc.) — never raw `mv`/`cp`/`rm` on task directories. For (b), handle as normal conversation.
 

{hermes_task_framework-1.2.0 → hermes_task_framework-1.2.1}/hermes_task_framework/skills/task-framework/scripts/manage_task.py

@@ -9,7 +9,7 @@ task-framework 任务生命周期管理工具
   1. HERMES_TASKS_ROOT 或 HERMES_TASKS_DIR 环境变量
   2. 当前 profile config.yaml: tasks.data_dir
   3. 全局 ~/.hermes/config.yaml: tasks.data_dir
-  4. Fallback: ~/.hermes/tasks
+  4. Fallback: ~/studio/hermes/tasks (legacy ~/.hermes/tasks is never populated)
 
 Commands:
     create    创建新任务（目录 + hash + 元数据 + 模板 + 可选 inbox 移入）
@@ -22,12 +22,12 @@ Commands:
     reindex   重建索引文件（README.md + TASKS.md）
     init      为任务创建目录 + TASK.md + CHANGELOG.md + .hermes-task.json
     export    将任务打包为可移植 tar.gz
-    import    从 tar.gz 恢复任务
-    rebuild   按 hash 查找最近 tar.gz 并导入
+    import    从 tar.gz 或 zip 恢复任务
+    rebuild   按 hash 查找最近 tar.gz 或 zip 并导入
     migrate   一次性迁移：将旧存储目录下的文件迁移到统一目录
     ensure-all 全量注册所有现有任务
 """
-import os, sys, glob, json, shutil, re, tarfile, tempfile, hashlib, random, argparse, secrets
+import os, sys, glob, json, shutil, re, tarfile, zipfile, tempfile, hashlib, random, argparse, secrets
 from datetime import datetime
 from pathlib import Path
 
@@ -46,9 +46,11 @@ def _read_config_yaml(config_path):
 
 
 def _resolve_tasks_root() -> str:
-    """Priority chain: env → profile config → global config → fallback."""
-    # 1. Env var
-    env = os.environ.get("HERMES_TASKS_DIR", "").strip()
+    """Resolve the task root with ROOT as canonical and DIR as legacy fallback."""
+    # 1. Canonical env var, then the legacy pip-package compatibility alias.
+    env = os.environ.get("HERMES_TASKS_ROOT", "").strip()
+    if not env:
+        env = os.environ.get("HERMES_TASKS_DIR", "").strip()
     if env:
         return os.path.expanduser(env)
 
@@ -76,8 +78,8 @@ def _resolve_tasks_root() -> str:
             if val and isinstance(val, str):
                 return os.path.expanduser(val)
 
-    # 4. Fallback
-    return os.path.expanduser("~/.hermes/tasks")
+    # 4. Canonical fallback. Never populate the legacy ~/.hermes/tasks root.
+    return os.path.expanduser("~/studio/hermes/tasks")
 
 
 TASKS_ROOT = _resolve_tasks_root()
@@ -360,8 +362,15 @@ def cmd_import(archive_path):
         print(f"Archive not found: {archive_path}")
         return False
     with tempfile.TemporaryDirectory(prefix="task-import-") as tmp:
-        with tarfile.open(archive_path, 'r:gz') as tar:
-            tar.extractall(path=tmp)
+        if tarfile.is_tarfile(archive_path):
+            with tarfile.open(archive_path, 'r:gz') as tar:
+                tar.extractall(path=tmp)
+        elif zipfile.is_zipfile(archive_path):
+            with zipfile.ZipFile(archive_path) as archive:
+                archive.extractall(path=tmp)
+        else:
+            print(f"Unsupported archive format: {archive_path}")
+            return False
         extracted = os.listdir(tmp)
         print(f"Extracted: {extracted}")
 
@@ -415,16 +424,25 @@ def cmd_import(archive_path):
 
 
 def cmd_rebuild(hash_or_archive):
-    if tarfile.is_tarfile(hash_or_archive):
+    if os.path.isfile(hash_or_archive) and (
+        tarfile.is_tarfile(hash_or_archive) or zipfile.is_zipfile(hash_or_archive)
+    ):
         return cmd_import(hash_or_archive)
     h = hash_or_archive
     if not re.match(r'^[a-z0-9]{6}$', h):
         print(f"Invalid hash: {h}")
         return False
-    pattern = os.path.join(TASKS_ROOT, f"*{h}*.tar.gz")
-    matches = sorted(glob.glob(pattern), key=os.path.getmtime, reverse=True)
+    patterns = [
+        os.path.join(TASKS_ROOT, f"*{h}*.tar.gz"),
+        os.path.join(TASKS_ROOT, f"*{h}*.zip"),
+    ]
+    matches = sorted(
+        [match for pattern in patterns for match in glob.glob(pattern)],
+        key=os.path.getmtime,
+        reverse=True,
+    )
     if not matches:
-        print(f"No tar.gz found for hash {h} in {TASKS_ROOT}")
+        print(f"No tar.gz or zip found for hash {h} in {TASKS_ROOT}")
         return False
     archive = matches[0]
     print(f"Found: {archive}")

{hermes_task_framework-1.2.0 → hermes_task_framework-1.2.1}/hermes_task_framework/skills/task-framework/scripts/update-index.py

@@ -7,7 +7,7 @@ Regenerates both:
   2. tasks/TASKS.md   — aggregated checklist view (deep overview)
 
 Usage:
-  python3 scripts/update-index.py                     # default: $HERMES_TASKS_ROOT (or ~/.hermes/tasks)
+  python3 scripts/update-index.py                     # default: configured root or ~/studio/hermes/tasks
   python3 scripts/update-index.py --tasks-dir /path   # custom path
 """
 
@@ -61,8 +61,8 @@ def _resolve_tasks_root() -> str:
             if val and isinstance(val, str):
                 return os.path.expanduser(val)
 
-    # 4. Fallback
-    return os.path.expanduser("~/.hermes/tasks")
+    # 4. Canonical fallback. Never populate the legacy ~/.hermes/tasks root.
+    return os.path.expanduser("~/studio/hermes/tasks")
 
 
 TASKS_ROOT = _resolve_tasks_root()

{hermes_task_framework-1.2.0 → hermes_task_framework-1.2.1}/hermes_task_framework/skills/task-lifecycle-portability/SKILL.md

@@ -1,7 +1,7 @@
 ---
 author: Hermes Agent
 category: software-development
-description: Task migration, export/import, and file-protection model. Covers tar.gz
+description: Task migration, export/import, and file-protection model. Covers tar.gz and zip
   snapshots and manage.py lifecycle commands (export/import/rebuild).
 license: MIT
 metadata:
@@ -62,8 +62,8 @@ tasks/<ts>.<name>-<hash6>/
 | Command | What it does |
 |---------|-------------|
 | `export <hash>` | Package task directory as `tasks/<ts>.<name>-<hash>.tar.gz` (excludes `output/`, includes `input/` + metadata files) |
-| `import <tar.gz>` | Extract to `tasks/` directory, restore all files |
-| `rebuild <hash>` | Find latest `<hash>.tar.gz` in `tasks/`, extract. Generates semantic directory name from TASK.md title |
+| `import <tar.gz-or-zip>` | Extract to `tasks/` directory, restore all files |
+| `rebuild <hash>` | Find latest `<hash>.tar.gz` or `<hash>.zip` in `tasks/`, extract. Generates semantic directory name from TASK.md title |
 
 **Actual script path:**
 `scripts/manage_task.py  # from the task-framework skill directory`
@@ -73,12 +73,12 @@ Usage: `python3 <path> <command> <arg>`
 **Export behavior:**
 - Archive contains actual file content (no symlinks involved)
 - Output dir is excluded (it's regenerable via pipeline)
-- `tar.gz` acts as a portable backup that can be committed to git
+- `tar.gz` and `zip` act as portable backups that can be committed to git
 
 **Cross-machine strategy:**
 - No automatic merge — each machine's copy is an independent task
 - To combine work from two machines: create a new task referencing both via `ref:<hash>/...`
-- `tar.gz` in git repo acts as backup
+- `tar.gz` or `zip` in git repo acts as backup
 
 ## Old Tasks (Migration)
 

hermes_task_framework-1.2.1/hermes_task_framework/tests/test_task_root_resolution.py

@@ -0,0 +1,122 @@
+import importlib.util
+import os
+from pathlib import Path
+import subprocess
+import sys
+import tempfile
+import unittest
+import zipfile
+
+
+SCRIPT = (
+    Path(__file__).resolve().parents[1]
+    / "skills"
+    / "task-framework"
+    / "scripts"
+    / "manage_task.py"
+)
+
+
+def load_manage_task():
+    spec = importlib.util.spec_from_file_location("manage_task_under_test", SCRIPT)
+    if spec is None or spec.loader is None:
+        raise RuntimeError(f"Cannot load {SCRIPT}")
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+class TaskRootResolutionTests(unittest.TestCase):
+    def setUp(self):
+        self.original = {
+            "HERMES_TASKS_ROOT": os.environ.get("HERMES_TASKS_ROOT"),
+            "HERMES_TASKS_DIR": os.environ.get("HERMES_TASKS_DIR"),
+            "HERMES_HOME": os.environ.get("HERMES_HOME"),
+        }
+        os.environ["HERMES_HOME"] = "/tmp/hermes-task-framework-test-profile"
+
+    def tearDown(self):
+        for key, value in self.original.items():
+            if value is None:
+                os.environ.pop(key, None)
+            else:
+                os.environ[key] = value
+
+    def test_root_is_canonical_when_both_variables_are_set(self):
+        os.environ["HERMES_TASKS_ROOT"] = "/tmp/canonical-tasks"
+        os.environ["HERMES_TASKS_DIR"] = "/tmp/legacy-tasks"
+        module = load_manage_task()
+        self.assertEqual(module.TASKS_ROOT, "/tmp/canonical-tasks")
+
+    def test_legacy_dir_is_used_as_fallback(self):
+        os.environ.pop("HERMES_TASKS_ROOT", None)
+        os.environ["HERMES_TASKS_DIR"] = "/tmp/legacy-tasks"
+        module = load_manage_task()
+        self.assertEqual(module.TASKS_ROOT, "/tmp/legacy-tasks")
+
+    def test_canonical_root_is_used_when_no_override_or_config_exists(self):
+        os.environ.pop("HERMES_TASKS_ROOT", None)
+        os.environ.pop("HERMES_TASKS_DIR", None)
+        module = load_manage_task()
+        self.assertEqual(module.TASKS_ROOT, str(Path.home() / "studio" / "hermes" / "tasks"))
+
+    def test_create_command_uses_root_without_legacy_alias(self):
+        with tempfile.TemporaryDirectory() as temp_dir:
+            env = os.environ.copy()
+            env["HERMES_TASKS_ROOT"] = temp_dir
+            env.pop("HERMES_TASKS_DIR", None)
+            result = subprocess.run(
+                [sys.executable, str(SCRIPT), "create", "root-only-test"],
+                cwd=SCRIPT.parent,
+                env=env,
+                capture_output=True,
+                text=True,
+                check=True,
+            )
+            self.assertIn(temp_dir, result.stdout)
+            created = list(Path(temp_dir).glob("*.root-only-test-*"))
+            self.assertEqual(len(created), 1)
+            self.assertTrue((created[0] / ".hermes-task.json").exists())
+
+    def test_import_accepts_zip_archive(self):
+        module = load_manage_task()
+        with tempfile.TemporaryDirectory() as temp_dir:
+            setattr(module, "TASKS_ROOT", temp_dir)
+            task_name = "20260813-120000.zip-import-a1b2c3"
+            task_dir = Path(temp_dir) / task_name
+            staging = Path(temp_dir) / "staging" / task_name
+            staging.mkdir(parents=True)
+            (staging / "TASK.md").write_text("# Task: ZIP import\n", encoding="utf-8")
+            (staging / ".hermes-task.json").write_text(
+                '{"hash": "a1b2c3", "name": "zip-import"}', encoding="utf-8"
+            )
+            archive_path = Path(temp_dir) / f"{task_name}.zip"
+            with zipfile.ZipFile(archive_path, "w") as archive:
+                for path in staging.rglob("*"):
+                    archive.write(path, path.relative_to(staging.parent))
+
+            self.assertTrue(module.cmd_import(str(archive_path)))
+            self.assertTrue((task_dir / "TASK.md").exists())
+
+    def test_rebuild_discovers_latest_zip_archive(self):
+        module = load_manage_task()
+        with tempfile.TemporaryDirectory() as temp_dir:
+            setattr(module, "TASKS_ROOT", temp_dir)
+            task_name = "20260813-120000.zip-rebuild-d4e5f6"
+            archive_path = Path(temp_dir) / f"{task_name}.zip"
+            staging = Path(temp_dir) / "staging" / task_name
+            staging.mkdir(parents=True)
+            (staging / "TASK.md").write_text("# Task: ZIP rebuild\n", encoding="utf-8")
+            (staging / ".hermes-task.json").write_text(
+                '{"hash": "d4e5f6", "name": "zip-rebuild"}', encoding="utf-8"
+            )
+            with zipfile.ZipFile(archive_path, "w") as archive:
+                for path in staging.rglob("*"):
+                    archive.write(path, path.relative_to(staging.parent))
+
+            self.assertTrue(module.cmd_rebuild("d4e5f6"))
+            self.assertTrue((Path(temp_dir) / task_name / "TASK.md").exists())
+
+
+if __name__ == "__main__":
+    unittest.main()

{hermes_task_framework-1.2.0 → hermes_task_framework-1.2.1}/hermes_task_framework.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hermes-task-framework
-Version: 1.2.0
+Version: 1.2.1
 Summary: Structured task management skills for Hermes Agent — task creation, decomposition, stage gates
 Project-URL: Source, https://github.com/nuffin/hermes-task-framework-pip
 Requires-Python: >=3.11

{hermes_task_framework-1.2.0 → hermes_task_framework-1.2.1}/hermes_task_framework.egg-info/SOURCES.txt

@@ -51,4 +51,5 @@ hermes_task_framework/skills/task-lifecycle-portability/references/pipeline-outp
 hermes_task_framework/skills/task-lifecycle-portability/references/task-recovery-5d5a1a-example.md
 hermes_task_framework/skills/task-lifecycle-portability/references/task-recovery-procedure.md
 hermes_task_framework/skills/task-timestamp-convention/SKILL.md
-hermes_task_framework/skills/task-tracker/SKILL.md
+hermes_task_framework/skills/task-tracker/SKILL.md
+hermes_task_framework/tests/test_task_root_resolution.py

{hermes_task_framework-1.2.0 → hermes_task_framework-1.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hermes-task-framework"
-version = "1.2.0"
+version = "1.2.1"
 description = "Structured task management skills for Hermes Agent — task creation, decomposition, stage gates"
 requires-python = ">=3.11"
 dependencies = []