@hunyed15/codecgc 0.1.0

package/scripts/init_codecgc_roadmap.py

@@ -0,0 +1,134 @@
+import argparse
+import json
+import re
+import sys
+from pathlib import Path
+
+from codecgc_roadmap_templates import render_delivery_plan
+from codecgc_roadmap_templates import render_overview
+from codecgc_roadmap_templates import render_phases
+
+
+WORKSPACE = Path(__file__).resolve().parents[1]
+ROADMAP_ROOT = WORKSPACE / "codecgc" / "roadmap"
+
+
+def slugify(value: str) -> str:
+    normalized = value.strip().lower()
+    normalized = re.sub(r"[^a-z0-9]+", "-", normalized)
+    normalized = re.sub(r"-{2,}", "-", normalized).strip("-")
+    if not normalized:
+        raise ValueError("Roadmap slug cannot be empty after normalization.")
+    return normalized
+
+
+def write_file(path: Path, content: str, force: bool) -> None:
+    if path.exists() and not force:
+        raise FileExistsError(f"File already exists: {path}")
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(content, encoding="utf-8")
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(description="Initialize a CodeCGC roadmap scaffold.")
+    parser.add_argument("--slug", required=True)
+    parser.add_argument("--summary", required=True)
+    parser.add_argument("--artifact-class", choices=["product", "fixture"], default="product")
+    parser.add_argument("--goal", default="")
+    parser.add_argument("--user-story", default="")
+    parser.add_argument("--context", action="append", default=[])
+    parser.add_argument("--in-scope", action="append", default=[])
+    parser.add_argument("--risk", action="append", default=[])
+    parser.add_argument("--dependency", action="append", default=[])
+    parser.add_argument("--assumption", action="append", default=[])
+    parser.add_argument("--validation", action="append", default=[])
+    parser.add_argument("--rollback", action="append", default=[])
+    parser.add_argument("--open-question", action="append", default=[])
+    parser.add_argument("--reason", action="append", default=[])
+    parser.add_argument("--frontend-path", action="append", default=[])
+    parser.add_argument("--backend-path", action="append", default=[])
+    parser.add_argument("--shared-path", action="append", default=[])
+    parser.add_argument("--unknown-path", action="append", default=[])
+    parser.add_argument("--force", action="store_true")
+    return parser
+
+
+def main() -> int:
+    parser = build_parser()
+    args = parser.parse_args()
+
+    try:
+        slug = slugify(args.slug)
+        directory = ROADMAP_ROOT / slug
+        grouped_paths = {
+            "frontend": args.frontend_path,
+            "backend": args.backend_path,
+            "shared": args.shared_path,
+            "unknown": args.unknown_path,
+        }
+
+        overview_path = directory / "overview.md"
+        phases_path = directory / "phases.md"
+        delivery_plan_path = directory / "delivery-plan.md"
+
+        write_file(
+            overview_path,
+            render_overview(
+                initiative=slug,
+                summary=args.summary,
+                user_story=args.user_story,
+                goal=args.goal,
+                context=args.context,
+                scope=args.in_scope,
+                risks=args.risk,
+                reasons=args.reason,
+                artifact_class=args.artifact_class,
+            ),
+            args.force,
+        )
+        write_file(
+            phases_path,
+            render_phases(
+                initiative=slug,
+                grouped_paths=grouped_paths,
+                artifact_class=args.artifact_class,
+            ),
+            args.force,
+        )
+        write_file(
+            delivery_plan_path,
+            render_delivery_plan(
+                initiative=slug,
+                dependencies=args.dependency,
+                assumptions=args.assumption,
+                validation=args.validation,
+                rollback=args.rollback,
+                open_questions=args.open_question,
+                artifact_class=args.artifact_class,
+            ),
+            args.force,
+        )
+    except Exception as error:
+        print(json.dumps({"success": False, "error": str(error)}, ensure_ascii=False, indent=2), file=sys.stderr)
+        return 1
+
+    print(
+        json.dumps(
+            {
+                "success": True,
+                "directory": str(directory),
+                "files": {
+                    "overview": str(overview_path),
+                    "phases": str(phases_path),
+                    "delivery_plan": str(delivery_plan_path),
+                },
+            },
+            ensure_ascii=False,
+            indent=2,
+        )
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/scripts/init_codecgc_workflow.py

@@ -0,0 +1,207 @@
+import argparse
+import datetime as dt
+import json
+import re
+import sys
+from pathlib import Path
+
+from codecgc_artifact_roots import flow_root
+from codecgc_console_io import configure_utf8_stdio
+from codecgc_console_io import print_json
+from codecgc_workflow_templates import build_feature_paths
+from codecgc_workflow_templates import build_issue_paths
+from codecgc_workflow_templates import render_feature_acceptance
+from codecgc_workflow_templates import render_feature_checklist
+from codecgc_workflow_templates import render_feature_design
+from codecgc_workflow_templates import render_issue_analysis
+from codecgc_workflow_templates import render_issue_fix
+from codecgc_workflow_templates import render_issue_fix_note
+from codecgc_workflow_templates import render_issue_report
+
+
+def slugify(value: str) -> str:
+    normalized = value.strip().lower()
+    normalized = re.sub(r"[^a-z0-9]+", "-", normalized)
+    normalized = re.sub(r"-{2,}", "-", normalized).strip("-")
+    if not normalized:
+        raise ValueError("工作流 slug 归一化后不能为空。")
+    return normalized
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        description="初始化最小可用的 CodeCGC 功能开发或问题修复工作流产物。"
+    )
+    parser.add_argument(
+        "--flow",
+        required=True,
+        choices=["feature", "issue"],
+        help="要初始化的工作流类型。",
+    )
+    parser.add_argument(
+        "--slug",
+        required=True,
+        help="新工作流目录使用的稳定 slug。",
+    )
+    parser.add_argument(
+        "--summary",
+        required=True,
+        help="面向人的一句话摘要。",
+    )
+    parser.add_argument(
+        "--date",
+        default=dt.date.today().isoformat(),
+        help="目录日期前缀，格式为 YYYY-MM-DD。",
+    )
+    parser.add_argument(
+        "--target-path",
+        action="append",
+        default=[],
+        help="可选：首个可执行步骤的初始目标路径。",
+    )
+    parser.add_argument(
+        "--kind",
+        choices=["auto", "frontend", "backend"],
+        default="auto",
+        help="可选：首个可执行步骤的初始归属类型。",
+    )
+    parser.add_argument(
+        "--artifact-class",
+        choices=["product", "fixture"],
+        default="product",
+        help="指定生成产物属于 product 还是 fixture。",
+    )
+    parser.add_argument(
+        "--force",
+        action="store_true",
+        help="如果目标文件已存在，则允许覆盖。",
+    )
+    return parser
+
+
+def ensure_parent(path: Path) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+
+
+def write_file(path: Path, content: str, force: bool) -> None:
+    if path.exists() and not force:
+        raise FileExistsError(f"文件已存在：{path}")
+    ensure_parent(path)
+    path.write_text(content, encoding="utf-8")
+
+
+def init_feature(
+    flow_dir: Path,
+    slug: str,
+    summary: str,
+    created_date: str,
+    kind: str,
+    target_paths: list[str],
+    artifact_class: str,
+    force: bool,
+) -> dict[str, str]:
+    paths = build_feature_paths(flow_dir, slug)
+    write_file(
+        paths["design"],
+        render_feature_design(flow_dir.name, summary, kind, target_paths, artifact_class=artifact_class),
+        force,
+    )
+    write_file(
+        paths["checklist"],
+        render_feature_checklist(flow_dir.name, slug, created_date, kind, target_paths, artifact_class=artifact_class),
+        force,
+    )
+    write_file(paths["acceptance"], render_feature_acceptance(summary, artifact_class=artifact_class), force)
+    return {name: str(path) for name, path in paths.items()}
+
+
+def init_issue(
+    flow_dir: Path,
+    slug: str,
+    summary: str,
+    created_date: str,
+    kind: str,
+    target_paths: list[str],
+    artifact_class: str,
+    force: bool,
+) -> dict[str, str]:
+    paths = build_issue_paths(flow_dir, slug)
+    write_file(
+        paths["report"],
+        render_issue_report(flow_dir.name, summary, kind, target_paths, artifact_class=artifact_class),
+        force,
+    )
+    write_file(
+        paths["analysis"],
+        render_issue_analysis(flow_dir.name, summary, kind, target_paths, artifact_class=artifact_class),
+        force,
+    )
+    write_file(
+        paths["fix"],
+        render_issue_fix(flow_dir.name, slug, created_date, kind, target_paths, artifact_class=artifact_class),
+        force,
+    )
+    write_file(
+        paths["fix_note"],
+        render_issue_fix_note(flow_dir.name, summary, created_date, artifact_class=artifact_class),
+        force,
+    )
+    return {name: str(path) for name, path in paths.items()}
+
+
+def main() -> int:
+    configure_utf8_stdio()
+    parser = build_parser()
+    args = parser.parse_args()
+
+    try:
+        slug = slugify(args.slug)
+        directory_name = f"{args.date}-{slug}"
+        root = flow_root(args.flow, args.artifact_class)
+        flow_dir = root / directory_name
+
+        if args.flow == "feature":
+            created = init_feature(
+                flow_dir,
+                slug,
+                args.summary.strip(),
+                args.date,
+                args.kind,
+                args.target_path,
+                args.artifact_class,
+                args.force,
+            )
+        else:
+            created = init_issue(
+                flow_dir,
+                slug,
+                args.summary.strip(),
+                args.date,
+                args.kind,
+                args.target_path,
+                args.artifact_class,
+                args.force,
+            )
+    except Exception as error:
+        print_json(
+            {
+                "success": False,
+                "error": str(error),
+            },
+            file=sys.stderr,
+        )
+        return 1
+
+    print_json(
+        {
+            "success": True,
+            "flow": args.flow,
+            "directory": str(flow_dir),
+            "files": created,
+        }
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())