@michaelxwb/code-flow 0.8.1 → 1.0.0

package/src/core/code-flow/config.yml

@@ -1,161 +0,0 @@
-version: 1
-
-spec_workflow:
-    schema_version: 1
-    enforcement: required  # 推荐全门禁；历史 warn/inject 仅兼容部分验证降级，路由完整性错误始终阻断
-    drift_check: true
-    scope_expansion_check: true
-    metrics: true
-    catalog:
-        dedup_window: 5
-
-budget:
-    total: 2500
-    l0_max: 800
-    l1_max: 1700
-    map_max: 400
-    # catalog 模式下 spec 目录的 token 上限（超出按 Tier1 优先截断并告警）
-    catalog_max: 200
-
-# 质量闭环（v0.5）：合规反馈 + 学习采集。
-# enabled 仅 literal true 启用（缺失即关闭，升级用户行为不变）；
-# 子开关缺省跟随 enabled，仅 literal false 单独关闭。
-# 数据仅存本地 .code-flow/（.session-log.jsonl / .check-state.json）。
-quality_loop:
-    enabled: true
-    post_check: true            # PostToolUse 违规反馈（只提示不阻断）
-    stop_check: true            # Stop 收尾按 validation.yml 校验（heavy 项跳过）
-    finish_check: true          # 任务 finish 时全量执行 validation.yml（含 heavy，每任务一次）
-    correction_capture: true    # 纠正句式采集（喂 cf-learn 候选）
-    # 注入时对 spec 内容做保守无损压缩（去行尾空白、折叠多空行、剥 HTML 注释、去重 bullet）
-    # 缺省视为 true；仅显式 false 关闭
-    compress: true
-    compress_reminder: true     # 会话过长每 N 轮提醒 /compact（per-session 计数，缺省 true）
-    code_extensions:
-        - ".py"
-        - ".ts"
-        - ".tsx"
-        - ".js"
-        - ".jsx"
-        - ".go"
-        - ".java"
-        - ".rs"
-        - ".rb"
-        - ".vue"
-        - ".svelte"
-    skip_extensions:
-        - ".md"
-        - ".txt"
-        - ".json"
-        - ".yml"
-        - ".yaml"
-        - ".toml"
-        - ".lock"
-        - ".csv"
-        - ".xml"
-        - ".svg"
-        - ".png"
-        - ".jpg"
-        - ".jpeg"
-        - ".gif"
-        - ".ico"
-        - ".pdf"
-        - ".zip"
-        - ".gz"
-        - ".tar"
-    skip_paths:
-        - "docs/**"
-        - "*.config.*"
-        - ".code-flow/**"
-        - ".claude/**"
-        - ".codex/**"
-        - ".costrict/**"
-        - ".opencode/**"
-        - "node_modules/**"
-        - "dist/**"
-        - "build/**"
-        - "out/**"
-        - "coverage/**"
-        - ".next/**"
-        - ".cache/**"
-        - ".venv/**"
-        - "venv/**"
-        - "__pycache__/**"
-        - ".git/**"
-
-path_mapping:
-    shared:
-        # 共享模板供 cf-task:align / cf-task:prd 命令显式 Read 使用，
-        # 不是约束规范，禁止通配符自动注入。
-        # 仅 _map.md 保持 "*" 作为 Tier 0 导航。
-        specs:
-            - path: "shared/_map.md"
-              tags: ["*"]
-              tier: 0
-            - path: "shared/scenarios-template.md"
-              tags: []          # 永不自动注入，仅 align 显式 Read
-              tier: 1
-            - path: "shared/prd-template.md"
-              tags: []          # 永不自动注入，仅 cf-task:prd 命令显式 Read
-              tier: 1
-            - path: "shared/design/design-lite.md"
-              tags: []          # 永不自动注入，仅 cf-task:align 命令显式 Read
-              tier: 1
-            - path: "shared/design/design-full.md"
-              tags: []          # 永不自动注入，仅 cf-task:align 命令显式 Read
-              tier: 1
-            - path: "shared/design/design-frontend.md"
-              tags: []          # 永不自动注入，仅 cf-task:align 命令显式 Read（前端设计模板）
-              tier: 1
-    frontend:
-        patterns:
-            - "src/components/**"
-            - "src/pages/**"
-            - "src/hooks/**"
-            - "src/composables/**"
-            - "src/services/**"
-            - "src/styles/**"
-            - "**/*.tsx"
-            - "**/*.jsx"
-            - "**/*.css"
-            - "**/*.scss"
-        specs:
-            - path: "frontend/_map.md"
-              tags: ["*"]
-              tier: 0
-            - path: "frontend/directory-structure.md"
-              tags: ["directory", "structure", "folder", "route", "page", "layout"]
-              tier: 1
-            - path: "frontend/quality-standards.md"
-              tags: ["quality", "type", "lint", "error", "test", "state", "strict"]
-              tier: 1
-            - path: "frontend/component-specs.md"
-              tags: ["component", "prop", "hook", "render", "ui", "style"]
-              tier: 1
-    backend:
-        patterns:
-            - "services/**"
-            - "api/**"
-            - "models/**"
-            - "*.py"
-            - "**/*.py"
-            - "**/*.go"
-        specs:
-            - path: "backend/_map.md"
-              tags: ["*"]
-              tier: 0
-            - path: "backend/directory-structure.md"
-              tags: ["directory", "structure", "folder", "module", "layout"]
-              tier: 1
-            - path: "backend/logging.md"
-              tags: ["log", "logging", "debug", "trace", "monitor", "observe"]
-              tier: 1
-            - path: "backend/database.md"
-              tags: ["database", "db", "sql", "orm", "model", "migration", "query", "table", "schema"]
-              tier: 1
-            - path: "backend/platform-rules.md"
-              tags: ["api", "deploy", "config", "version", "compatibility", "release", "flag"]
-              tier: 1
-            - path: "backend/code-quality-performance.md"
-              tags: ["quality", "performance", "error", "exception", "test", "timeout", "retry", "cache"]
-              tier: 1

package/src/core/code-flow/runtime-commands.json

@@ -1,259 +0,0 @@
-{
-  "schema_version": 1,
-  "commands": {
-    "spec budget": {
-      "module": "cf_spec_context",
-      "prefix": ["budget"],
-      "example_args": "--help"
-    },
-    "spec impact": {
-      "module": "cf_spec_context",
-      "prefix": ["impact"],
-      "example_args": "--help"
-    },
-    "spec optimize": {
-      "module": "cf_spec_context",
-      "prefix": ["optimize"],
-      "example_args": "--help"
-    },
-    "spec catalog": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "catalog"
-      ],
-      "example_args": "--help"
-    },
-    "spec decision": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "decision"
-      ],
-      "example_args": "--help"
-    },
-    "spec bind": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "bind"
-      ],
-      "example_args": "--help"
-    },
-    "spec validate": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "validate"
-      ],
-      "example_args": "--task-dir \"<需求目录>\" --json"
-    },
-    "spec status": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "status"
-      ],
-      "example_args": "--task-dir \"<需求目录>\" --root \"$PWD\" --json"
-    },
-    "spec doctor": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "doctor"
-      ],
-      "example_args": "--task-dir \"<需求目录>\" --root \"$PWD\" --json"
-    },
-    "spec refresh": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "refresh"
-      ],
-      "example_args": "--task-dir \"<需求目录>\" --root \"$PWD\" --json"
-    },
-    "spec refresh-missing": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "refresh-missing"
-      ],
-      "example_args": "--help"
-    },
-    "spec active": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "active"
-      ],
-      "example_args": "--help"
-    },
-    "task start": {
-      "module": "cf_spec_context",
-      "prefix": [
-        "start"
-      ],
-      "example_args": "--task-dir \"<需求目录>\" --task-file \"<任务文件>\" --task TASK-001 --root \"$PWD\" --json"
-    },
-    "task finish": {
-      "module": "cf_task_workflow",
-      "prefix": [
-        "finish"
-      ],
-      "example_args": "--task-dir \"<需求目录>\" --task TASK-001 --root \"$PWD\" --json"
-    },
-    "task block": {
-      "module": "cf_task_workflow",
-      "prefix": [
-        "block"
-      ],
-      "example_args": "--help"
-    },
-    "task resume": {
-      "module": "cf_task_workflow",
-      "prefix": [
-        "resume"
-      ],
-      "example_args": "--help"
-    },
-    "task verify": {
-      "module": "cf_task_workflow",
-      "prefix": [
-        "verify"
-      ],
-      "example_args": "--task-dir \"<需求目录>\" --tasks TASK-001,TASK-002 --layers validators,e2e --profile smoke --root \"$PWD\" --json"
-    },
-    "task verify-e2e": {
-      "module": "cf_task_workflow",
-      "prefix": [
-        "verify-e2e"
-      ],
-      "example_args": "--task-dir \"<需求目录>\" --root \"$PWD\" --json"
-    },
-    "task confirm-manual": {
-      "module": "cf_task_workflow",
-      "prefix": [
-        "confirm-manual"
-      ],
-      "example_args": "--help"
-    },
-    "task cleanup-session": {
-      "module": "cf_task_workflow",
-      "prefix": [
-        "cleanup-session"
-      ],
-      "example_args": "--help"
-    },
-    "audit": {
-      "module": "cf_audit",
-      "prefix": [],
-      "example_args": "--task-dir \"<需求目录>\" --root \"$PWD\" --json"
-    },
-    "spec gate": {
-      "module": "cf_spec_gate",
-      "prefix": [],
-      "example_args": "--help"
-    },
-    "spec session": {
-      "module": "cf_spec_session",
-      "prefix": [],
-      "example_args": "--help"
-    },
-    "task index": {
-      "module": "cf_task_index",
-      "prefix": [],
-      "example_args": "--help"
-    },
-    "task parallel": {
-      "module": "cf_task_parallel",
-      "prefix": [],
-      "example_args": "--help"
-    },
-    "acceptance manifest": {
-      "module": "cf_acceptance_manifest",
-      "prefix": [],
-      "example_args": "--task-file \"<任务文件>\" --output \"<需求目录>/.acceptance-manifest.json\""
-    },
-    "acceptance project": {
-      "module": "cf_acceptance_manifest",
-      "prefix": [
-        "--project"
-      ],
-      "example_args": "--task-file \"<任务文件>\" --output \"<需求目录>/.acceptance-manifest.json\""
-    },
-    "acceptance risk": {
-      "module": "cf_acceptance_manifest",
-      "prefix": [
-        "--accept-risk"
-      ],
-      "example_args": "--task-file \"<任务文件>\" --output \"<需求目录>/.acceptance-manifest.json\" --check-id CHK-... --risk-owner \"<owner>\" --risk-reason \"<reason>\" --expires-at 2026-12-31 --confirmed-by \"<user>\" --source \"<user reply>\""
-    },
-    "acceptance run": {
-      "module": "cf_acceptance_runner",
-      "prefix": [],
-      "example_args": "--manifest \"<需求目录>/.acceptance-manifest.json\" --root \"$PWD\" --write-evidence"
-    },
-    "evidence import": {
-      "module": "cf_evidence_import",
-      "prefix": [
-        "import"
-      ],
-      "example_args": "--format junit --file \"<report.xml>\" --commit \"$(git rev-parse HEAD)\" --run-url \"<ci-run-url>\" --json"
-    },
-    "validate": {
-      "module": "cf_validation",
-      "prefix": [],
-      "example_args": "--root \"$PWD\" --json"
-    },
-    "stats": {
-      "module": "cf_stats",
-      "prefix": [],
-      "example_args": "--help"
-    },
-    "feedback ignore": {
-      "module": "cf_feedback",
-      "prefix": [
-        "ignore"
-      ],
-      "example_args": "--help"
-    },
-    "sync check": {
-      "module": "cf_sync",
-      "prefix": [
-        "check"
-      ],
-      "example_args": "--help"
-    },
-    "sync apply": {
-      "module": "cf_sync",
-      "prefix": [
-        "sync"
-      ],
-      "example_args": "--help"
-    },
-    "task archive": {
-      "module": "cf_task_workflow",
-      "prefix": [
-        "archive"
-      ],
-      "example_args": "--task-dir \"<需求目录>\" --root \"$PWD\" --json"
-    },
-    "scenarios parse": {
-      "module": "cf_scenarios",
-      "prefix": [
-        "parse"
-      ],
-      "example_args": "--file \"<需求>.scenarios.md\" --quality --json"
-    },
-    "scenarios merge": {
-      "module": "cf_scenarios",
-      "prefix": [
-        "merge"
-      ],
-      "example_args": "--file a.scenarios.md --file b.scenarios.md --json"
-    },
-    "scenarios migrate": {
-      "module": "cf_scenarios",
-      "prefix": [
-        "migrate"
-      ],
-      "example_args": "--task-file \"<任务文件>\" --output \"<需求>.scenarios.md\" --json"
-    },
-    "design lint": {
-      "module": "cf_design_lint",
-      "prefix": [],
-      "example_args": "--file \"<需求>.design.md\" --scenarios-file \"<需求>.scenarios.md\" --json"
-    }
-  }
-}

package/src/core/code-flow/scripts/cf_acceptance_manifest.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_acceptance_manifest."""
-import sys
-
-from codeflow.cli import cf_acceptance_manifest as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_acceptance_runner.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_acceptance_runner."""
-import sys
-
-from codeflow.cli import cf_acceptance_runner as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_audit.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_audit."""
-import sys
-
-from codeflow.cli import cf_audit as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_codex_hook.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.hooks.cf_codex_hook."""
-import sys
-
-from codeflow.hooks import cf_codex_hook as _impl
-
-if __name__ == "__main__":
-    _impl.main()
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_design_lint.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_design_lint."""
-import sys
-
-from codeflow.cli import cf_design_lint as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_evidence_import.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_evidence_import."""
-import sys
-
-from codeflow.cli import cf_evidence_import as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_feedback.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_feedback."""
-import sys
-
-from codeflow.cli import cf_feedback as _impl
-
-if __name__ == "__main__":
-    sys.exit(_impl.main(sys.argv[1:]))
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_opencode_event.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.hooks.cf_opencode_event."""
-import sys
-
-from codeflow.hooks import cf_opencode_event as _impl
-
-if __name__ == "__main__":
-    _impl.main()
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_post_hook.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.hooks.cf_post_hook."""
-import sys
-
-from codeflow.hooks import cf_post_hook as _impl
-
-if __name__ == "__main__":
-    _impl.main()
-    _impl.timing_log("cf_post_hook")
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_pre_tool_hook.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.hooks.cf_pre_tool_hook."""
-import sys
-
-from codeflow.hooks import cf_pre_tool_hook as _impl
-
-if __name__ == "__main__":
-    _impl.main()
-    _impl.timing_log("cf_pre_tool_hook")
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_scenarios.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_scenarios."""
-import sys
-
-from codeflow.cli import cf_scenarios as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_spec_context.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_spec_context."""
-import sys
-
-from codeflow.cli import cf_spec_context as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_spec_gate.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_spec_gate."""
-import sys
-
-from codeflow.cli import cf_spec_gate as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_spec_session.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_spec_session."""
-import sys
-
-from codeflow.cli import cf_spec_session as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_stats.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_stats."""
-import sys
-
-from codeflow.cli import cf_stats as _impl
-
-if __name__ == "__main__":
-    _impl.main()
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_stop_hook.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.hooks.cf_stop_hook."""
-import sys
-
-from codeflow.hooks import cf_stop_hook as _impl
-
-if __name__ == "__main__":
-    _impl.main()
-    _impl.timing_log("cf_stop_hook")
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_sync.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_sync."""
-import sys
-
-from codeflow.cli import cf_sync as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_task_index.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_task_index."""
-import sys
-
-from codeflow.cli import cf_task_index as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_task_parallel.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_task_parallel."""
-import sys
-
-from codeflow.cli import cf_task_parallel as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_task_workflow.py

@@ -1,10 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.cli.cf_task_workflow."""
-import sys
-
-from codeflow.cli import cf_task_workflow as _impl
-
-if __name__ == "__main__":
-    raise SystemExit(_impl.main())
-else:
-    sys.modules[__name__] = _impl

package/src/core/code-flow/scripts/cf_user_prompt_hook.py

@@ -1,11 +0,0 @@
-#!/usr/bin/env python3
-"""Path-frozen entry shim: implementation lives in codeflow.hooks.cf_user_prompt_hook."""
-import sys
-
-from codeflow.hooks import cf_user_prompt_hook as _impl
-
-if __name__ == "__main__":
-    _impl.main()
-    _impl.timing_log("cf_user_prompt_hook")
-else:
-    sys.modules[__name__] = _impl