specmodule 0.1.3__tar.gz → 0.2.0__tar.gz

{specmodule-0.1.3/specmodule.egg-info → specmodule-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: specmodule
-Version: 0.1.3
+Version: 0.2.0
 Summary: 可审计、可调试、可完全掌控的 LLM 使用框架（tickflow + llm + module_harness）
 License: MIT
 Keywords: llm,workflow,petri-net,agent
@@ -15,7 +15,7 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: tickflow-py>=0.1.0
+Requires-Dist: tickflow-py<0.3,>=0.2.0
 Provides-Extra: anthropic
 Requires-Dist: anthropic; extra == "anthropic"
 Provides-Extra: openai

{specmodule-0.1.3 → specmodule-0.2.0}/llm/config.py

@@ -97,7 +97,7 @@ class LLMConfig:
     timeout: float = 60.0
     max_retries: int = 3
 
-    # ── 默认模型参数（harness 未指定时兜底）──
+    # ── 默认模型参数（harness 未指定时兜底；model/max_tokens/temperature 来自 config.json models[0]）──
     model: str = ""
     max_tokens: int = 4096
     temperature: float = 0.7
@@ -168,6 +168,7 @@ class LLMConfig:
         models_map: dict[str, dict[str, Any]] = {}
         default_model = ""
         default_temperature = 0.7
+        default_max_tokens = 4096
 
         for m in models:
             name = m.get("name", "")
@@ -176,6 +177,7 @@ class LLMConfig:
             if not default_model:
                 default_model = name
                 default_temperature = float(m.get("temperature", 0.7))
+                default_max_tokens = int(m.get("max_tokens", 4096))
 
         config = cls(
             provider=p.get("sdktype", "openai"),
@@ -184,7 +186,7 @@ class LLMConfig:
             timeout=float(p.get("timeout", 60.0)),
             max_retries=int(p.get("max_retries", 3)),
             model=overrides.pop("model", None) or default_model,
-            max_tokens=int(overrides.pop("max_tokens", None) or 4096),
+            max_tokens=int(overrides.pop("max_tokens", None) or default_max_tokens),
             temperature=float(overrides.pop("temperature", None) or default_temperature),
             models=models_map,
             system_rules=system_rules,

{specmodule-0.1.3 → specmodule-0.2.0}/module_harness/__init__.py

@@ -1,10 +1,38 @@
 # module_harness/__init__.py
 """ModuleHarness — tickflow 上层抽象：harness 与 script 执行元件。"""
 
-from .config import HarnessConfig
-from .outputfmt import OutputFormat, OutputValidator
-from .prompt import PromptRenderer
-from .events import (
+# core：核心执行元件
+from .core.config import HarnessConfig
+from .core.outputfmt import OutputFormat, OutputValidator
+from .core.prompt import PromptRenderer
+from .core.harness import Harness
+from .core.call import HarnessCallError, HarnessCallResult, call_harness
+from .core.registry import HarnessRegistry
+from .core.builtins import BUILTIN_HARNESS_NAMES, register_builtin_harnesses
+# model：数据模型与模块形态
+from .model.spec import (
+    Spec,
+    TaskDefinition,
+    Tasklist,
+    TranslationSpec,
+    TasklistTemplate,
+)
+from .model.spec import SpecSchema
+from .model.translator import TasklistValidator, TemplateLoader, Translator
+from .model.module import Module
+from .model.submodule import SubModule, SpecValidationError, script
+# orchestrate：图编排
+from .orchestrate.consistency import (
+    ConsistencyError,
+    ConsistencyReport,
+    ConsistencyReviewer,
+    REVIEW_HARNESS_CONFIG,
+    register_review_harness,
+)
+from .orchestrate.align import ALIGN_CHECK_CONFIG, register_align_check_harness
+from .orchestrate.graph_builder import TasklistTranslator
+# infra：运行基础设施
+from .infra.events import (
     EventBus,
     HarnessEvent,
     PromptRendered,
@@ -22,34 +50,8 @@ from .events import (
     CommandCompleted,
     CommandFailed,
 )
-from .command import Command, CommandConfig
-from .harness import Harness
-from .registry import HarnessRegistry
-from .spec import (
-    Spec,
-    TaskDefinition,
-    Tasklist,
-    TranslationSpec,
-    TasklistTemplate,
-)
-from .consistency import (
-    ConsistencyError,
-    ConsistencyReport,
-    ConsistencyReviewer,
-    REVIEW_HARNESS_CONFIG,
-    register_review_harness,
-)
-from .align import ALIGN_CHECK_CONFIG, register_align_check_harness
-from .builtins import BUILTIN_HARNESS_NAMES, register_builtin_harnesses
-from .translator import TasklistValidator, TemplateLoader, Translator
-from .graph_builder import TasklistTranslator
-from .module import Module
-from .submodule import SubModule, SpecValidationError, script
-from .loader import ModuleLoader, ModuleManifestError, ModuleRequirementError
-from .spec import SpecSchema
-from .status import ModuleStatus, query_run_status
-from .entry import ModuleEntry, discover_modules
-from .query import (
+from .infra.status import ModuleStatus, query_run_status
+from .infra.query import (
     CheckpointEntry,
     CheckpointList,
     QueryValueResult,
@@ -57,29 +59,33 @@ from .query import (
     ReviewTimeline,
     build_checkpoints,
     build_timeline,
+    check_resume_compat_from_run,
     checkpoints_to_dict,
     create_checkpoint,
+    delete_run,
     filter_failed,
     filter_node,
     filter_tick,
+    list_runs,
     load_snapshot_summary,
     query_value,
     run_db_path,
     timeline_to_dict,
 )
-from .checkpoint import (
+from .infra.checkpoint import (
     ModuleInputStore,
     ResumeCheck,
     ResumeError,
     check_resume_compat,
 )
-from . import store as store_module
-from .store import (
+from .infra.store import (
     ENTRY_POINT_GROUP,
     ModuleSource,
+    ResolvedModule,
     apply_update,
     cache_dir,
     check_updates,
+    detail_to_dict,
     file_sha256,
     install_pack,
     list_modules,
@@ -89,12 +95,27 @@ from .store import (
     parse_dotenv,
     pip_entry_point_dirs,
     resolve_module,
+    resolve_module_full,
     search_paths,
     store_home,
     uninstall_pack,
     validate_pack_dir,
 )
+# cli 层（CLI 实现，非库面）
+from .cli.command import Command, CommandConfig
+from .cli.entry import ModuleEntry, discover_modules
+from .cli.loader import ModuleLoader, ModuleManifestError, ModuleRequirementError
+
+# 模块对象绑定（`from module_harness import store / submodule / query` 可用；
+# query 共享层是 embedding.md 明示的顶层导出面）
+from .infra import store
+from .infra import query
+from .model import submodule
 
+# 嵌入者最小面（用法见 docs/guides/embedding.md）：
+#   task 级 = call_harness / HarnessCallResult / HarnessCallError
+#   图级   = Module / HarnessRegistry + HarnessConfig / OutputFormat / EventBus
+#             + TemplateLoader + register_builtin_harnesses
 __all__ = [
     # 配置
     "HarnessConfig",
@@ -118,6 +139,10 @@ __all__ = [
     "ScriptFailed",
     # 核心
     "Harness",
+    # task 级 API 地板（嵌入者消费面，docs/dev/superpowers/specs/2026-09-01-embedder-face-design.md）
+    "HarnessCallResult",
+    "HarnessCallError",
+    "call_harness",
     "HarnessRegistry",
     "Command",
     "CommandConfig",
@@ -168,6 +193,7 @@ __all__ = [
     "ResumeCheck",
     "ResumeError",
     "check_resume_compat",
+    "check_resume_compat_from_run",
     # 模块入口（roadmap Phase 0：CLI 使用）
     "ModuleEntry",
     "discover_modules",
@@ -189,11 +215,17 @@ __all__ = [
     "checkpoints_to_dict",
     "create_checkpoint",
     "load_snapshot_summary",
+    # 共享查询层（run 历史枚举与删除）
+    "list_runs",
+    "delete_run",
     # store 共享层（module-user-store：家目录/枚举/安装管理）
     "store_home",
     "search_paths",
     "list_modules",
     "resolve_module",
+    "resolve_module_full",
+    "ResolvedModule",
+    "detail_to_dict",
     "ModuleSource",
     "ENTRY_POINT_GROUP",
     "pip_entry_point_dirs",

specmodule-0.2.0/module_harness/cli/__init__.py

@@ -0,0 +1,19 @@
+# module_harness/cli
+"""CLI 层：命令行入口、模块发现/装载、脚手架、command 节点。
+
+``main`` 惰性再导出（PEP 562）：core.registry import 本包的 command 节点时，
+不得经包 __init__ 急切拉入 cli.cli 的重 import 链（会与
+infra.checkpoint → orchestrate.graph_builder → core.registry 成环）。
+"""
+
+from typing import Any
+
+__all__ = ["main"]
+
+
+def __getattr__(name: str) -> Any:
+    if name == "main":
+        from module_harness.cli.cli import main
+
+        return main
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

specmodule-0.2.0/module_harness/cli/__main__.py

@@ -0,0 +1,6 @@
+# module_harness/cli/__main__.py
+"""支持 ``python -m module_harness.cli``。"""
+
+from module_harness.cli.cli import main
+
+main()