duaer-spec 0.1.0

package/.duaer/extensions/git/scripts/python/git_common.py

@@ -0,0 +1,81 @@
+#!/usr/bin/env python3
+"""Git-specific common helpers for the git extension.
+
+Python port of ``git-common.sh`` / ``git-common.ps1`` — contains only
+git-specific branch validation and detection logic.
+"""
+
+from __future__ import annotations
+
+import re
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+def has_git(repo_root: Path | None = None) -> bool:
+    """Check if we have git available at the repo root."""
+    root = Path(repo_root) if repo_root is not None else Path.cwd()
+    git_marker = root / ".git"
+    if not (git_marker.is_dir() or git_marker.is_file()):
+        return False
+    if shutil.which("git") is None:
+        return False
+    result = subprocess.run(
+        ["git", "-C", str(root), "rev-parse", "--is-inside-work-tree"],
+        capture_output=True,
+        text=True,
+    )
+    return result.returncode == 0
+
+
+def effective_branch_name(raw: str) -> str:
+    """Strip a single optional path segment (e.g. gitflow "feat/004-name" -> "004-name").
+
+    Only when the full name is exactly two slash-free segments; otherwise
+    returns the raw name.
+    """
+    match = re.fullmatch(r"([^/]+)/([^/]+)", raw)
+    if match:
+        return match.group(2)
+    return raw
+
+
+def check_feature_branch(raw: str, has_git_repo: bool) -> bool:
+    """Validate that a branch name matches the expected feature branch pattern.
+
+    Accepts sequential (###-* with >=3 digits) or timestamp (YYYYMMDD-HHMMSS-*)
+    formats, either at the start of the branch or after path-style namespace
+    prefixes. Logic aligned with the bash/PowerShell twins.
+    """
+    if not has_git_repo:
+        print(
+            "[specify] Warning: Git repository not detected; skipped branch validation",
+            file=sys.stderr,
+        )
+        return True
+
+    branch = effective_branch_name(raw)
+    feature_segment = branch.rsplit("/", 1)[-1]
+
+    # Accept sequential prefix (3+ digits) but exclude malformed timestamps:
+    # 7-or-8 digit date + 6-digit time with no trailing slug.
+    is_sequential = bool(
+        re.match(r"^[0-9]{3,}-", feature_segment)
+        and not re.match(r"^[0-9]{7}-[0-9]{6}-", feature_segment)
+        and not re.fullmatch(r"[0-9]{7,8}-[0-9]{6}", feature_segment)
+    )
+    is_timestamp = bool(re.match(r"^[0-9]{8}-[0-9]{6}-", feature_segment))
+
+    if not is_sequential and not is_timestamp:
+        print(f"ERROR: Not on a feature branch. Current branch: {raw}", file=sys.stderr)
+        print(
+            "Feature branches should be named like: 001-feature-name, "
+            "1234-feature-name, 20260319-143022-feature-name, or "
+            "<prefix>/001-feature-name",
+            file=sys.stderr,
+        )
+        return False
+
+    return True

package/.duaer/extensions/git/scripts/python/initialize_repo.py

@@ -0,0 +1,89 @@
+#!/usr/bin/env python3
+"""Git extension: initialize_repo.py
+
+Initialize a Git repository with an initial commit.
+Python port of ``initialize-repo.sh`` / ``initialize-repo.ps1``.
+Customizable — replace this script to add .gitignore templates,
+default branch config, git-flow, LFS, signing, etc.
+"""
+
+from __future__ import annotations
+
+import re
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+
+def _find_project_root(start: Path) -> Path | None:
+    current = start
+    while True:
+        if (current / ".duaer").is_dir() or (current / ".git").exists():
+            return current
+        if current.parent == current:
+            return None
+        current = current.parent
+
+
+def _read_commit_message(repo_root: Path) -> str:
+    """Read init_commit_message from git-config.yml, mirroring the bash sed pipeline."""
+    default = "[Duaer] Initial commit"
+    config_file = repo_root / ".duaer" / "extensions" / "git" / "git-config.yml"
+    if not config_file.is_file():
+        return default
+    try:
+        lines = config_file.read_text(encoding="utf-8").splitlines()
+    except (OSError, UnicodeDecodeError):
+        return default
+    for line in lines:
+        if line.startswith("init_commit_message:"):
+            value = re.sub(r"^init_commit_message:\s*", "", line)
+            value = re.sub(r"^[\"']", "", value)
+            value = re.sub(r"[\"']*$", "", value)
+            if value:
+                return value
+    return default
+
+
+def main() -> int:
+    script_dir = Path(__file__).resolve().parent
+    repo_root = _find_project_root(script_dir) or Path.cwd()
+
+    commit_msg = _read_commit_message(repo_root)
+
+    if shutil.which("git") is None:
+        print(
+            "[specify] Warning: Git not found; skipped repository initialization",
+            file=sys.stderr,
+        )
+        return 0
+
+    probe = subprocess.run(
+        ["git", "rev-parse", "--is-inside-work-tree"],
+        cwd=repo_root,
+        capture_output=True,
+        text=True,
+    )
+    if probe.returncode == 0:
+        print("[specify] Git repository already initialized; skipping", file=sys.stderr)
+        return 0
+
+    steps = [
+        (["git", "init", "-q"], "git init"),
+        (["git", "add", "."], "git add"),
+        (["git", "commit", "--allow-empty", "-q", "-m", commit_msg], "git commit"),
+    ]
+    for cmd, label in steps:
+        result = subprocess.run(cmd, cwd=repo_root, capture_output=True, text=True)
+        if result.returncode != 0:
+            output = (result.stdout + result.stderr).strip()
+            print(f"[specify] Error: {label} failed: {output}", file=sys.stderr)
+            return 1
+
+    print("[OK] Git repository initialized", file=sys.stderr)
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/.duaer/extensions.yml

@@ -0,0 +1,167 @@
+installed:
+- git
+settings:
+  auto_execute_hooks: true
+hooks:
+  before_constitution:
+  - extension: git
+    command: duaer.git.initialize
+    enabled: true
+    optional: false
+    priority: 10
+    prompt: Execute duaer.git.initialize?
+    description: Initialize Git repository before constitution setup
+    condition: null
+  before_specify:
+  - extension: git
+    command: duaer.git.feature
+    enabled: true
+    optional: false
+    priority: 10
+    prompt: Execute duaer.git.feature?
+    description: Create feature branch before specification
+    condition: null
+  before_clarify:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit outstanding changes before clarification?
+    description: Auto-commit before spec clarification
+    condition: null
+  before_plan:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit outstanding changes before planning?
+    description: Auto-commit before implementation planning
+    condition: null
+  before_tasks:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit outstanding changes before task generation?
+    description: Auto-commit before task generation
+    condition: null
+  before_implement:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit outstanding changes before implementation?
+    description: Auto-commit before implementation
+    condition: null
+  before_checklist:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit outstanding changes before checklist?
+    description: Auto-commit before checklist generation
+    condition: null
+  before_analyze:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit outstanding changes before analysis?
+    description: Auto-commit before analysis
+    condition: null
+  before_taskstoissues:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit outstanding changes before issue sync?
+    description: Auto-commit before tasks-to-issues conversion
+    condition: null
+  after_constitution:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit constitution changes?
+    description: Auto-commit after constitution update
+    condition: null
+  after_specify:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit specification changes?
+    description: Auto-commit after specification
+    condition: null
+  after_clarify:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit clarification changes?
+    description: Auto-commit after spec clarification
+    condition: null
+  after_plan:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit plan changes?
+    description: Auto-commit after implementation planning
+    condition: null
+  after_tasks:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit task changes?
+    description: Auto-commit after task generation
+    condition: null
+  after_implement:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit implementation changes?
+    description: Auto-commit after implementation
+    condition: null
+  after_checklist:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit checklist changes?
+    description: Auto-commit after checklist generation
+    condition: null
+  after_analyze:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit analysis results?
+    description: Auto-commit after analysis
+    condition: null
+  after_taskstoissues:
+  - extension: git
+    command: duaer.git.commit
+    enabled: true
+    optional: true
+    priority: 10
+    prompt: Commit after syncing issues?
+    description: Auto-commit after tasks-to-issues conversion
+    condition: null

package/.duaer/init-options.json

@@ -0,0 +1,9 @@
+{
+  "ai": "cursor-agent",
+  "ai_skills": true,
+  "feature_numbering": "sequential",
+  "here": true,
+  "integration": "cursor-agent",
+  "script": "sh",
+  "speckit_version": "1.0.4"
+}

package/.duaer/integration.json

@@ -0,0 +1,15 @@
+{
+  "version": "1.0.4",
+  "integration_state_schema": 1,
+  "installed_integrations": [
+    "cursor-agent"
+  ],
+  "integration_settings": {
+    "cursor-agent": {
+      "script": "sh",
+      "invoke_separator": "-"
+    }
+  },
+  "integration": "cursor-agent",
+  "default_integration": "cursor-agent"
+}

package/.duaer/integrations/cursor-agent.manifest.json

@@ -0,0 +1,17 @@
+{
+  "integration": "cursor-agent",
+  "version": "1.0.4",
+  "installed_at": "2026-09-03T21:13:31.261739+00:00",
+  "files": {
+    ".cursor/skills/duaer-analyze/SKILL.md": "7deb401f0e53be0264722db1c2d401b279ca64ad3fc886a186de39f7ffd5be42",
+    ".cursor/skills/duaer-clarify/SKILL.md": "e1a1ddba9346721f41e7b8d0ad278b54d69399c0625db9d753756fd33e51a6e1",
+    ".cursor/skills/duaer-constitution/SKILL.md": "442e1c84f9a9f2267700cf08157b2aff65e00abae687689f639ce8f62ff8b6f5",
+    ".cursor/skills/duaer-implement/SKILL.md": "df979ca34543fbde2336626752ef72020aa68f4b38c2d108a2da4473113977db",
+    ".cursor/skills/duaer-converge/SKILL.md": "aca98c2c55ba124dbddc467642dc90c673f7657ff750b9a93d89916058dded0d",
+    ".cursor/skills/duaer-plan/SKILL.md": "3d13e010accc60766db3549a52f598e643f5f6c26570a475df418c7a74ba4cbb",
+    ".cursor/skills/duaer-checklist/SKILL.md": "057a2bd2cc91184a6a0b3b2e0fcf6704d4ef55cc1c5939b40e1968431ee10061",
+    ".cursor/skills/duaer-specify/SKILL.md": "d0b83970b14be40bd1dcd5d3c15f3186c37ebebbe4617dda7e8d487763b70f79",
+    ".cursor/skills/duaer-tasks/SKILL.md": "24e873a5a7adb75e832b6100d6c9140b0a0df4b9650ba32b8102e37697332beb",
+    ".cursor/skills/duaer-taskstoissues/SKILL.md": "225297f98e77807dd261ea5692ca0a5b286902d7c9b4855fc30b93f4283ce0a6"
+  }
+}

package/.duaer/integrations/duaer.manifest.json

@@ -0,0 +1,19 @@
+{
+  "integration": "duaer",
+  "version": "1.0.4",
+  "installed_at": "2026-09-03T21:13:31.277502+00:00",
+  "files": {
+    ".duaer/scripts/bash/common.sh": "170e91ece502b88d83c715e427473843e0b358f550e86e3ff524546df405a9ca",
+    ".duaer/scripts/bash/setup-plan.sh": "f417e1b8de7a48fa9d5fea3aabea8fe62149fa11c4b41b3103de06efe73dec8d",
+    ".duaer/scripts/bash/setup-tasks.sh": "4a33dd1e6c32ddc7d570f4b538572c54069192573eed0ec654d9fb826e31a4fe",
+    ".duaer/scripts/bash/check-prerequisites.sh": "daa377146db4fb69912f42611a7b91c5d55873b3e3e27ed33bd8d67505826344",
+    ".duaer/scripts/bash/resolve-template.sh": "829e227096abc8bf0889889ec9f792f503ca5d395b7836a8a7eb739ee75214e7",
+    ".duaer/scripts/bash/create-new-feature.sh": "fe99ea8da184380056ce8512ca5d37f67fb499ee4234835c15dcf7c4fb75451c",
+    ".duaer/templates/constitution-template.md": "ce7549540fa45543cca797a150201d868e64495fdff39dc38246fb17bd4024b3",
+    ".duaer/templates/checklist-template.md": "856532b3cb66171c662cc16f16b31a5856e4655a8666aad1e545bbfc7f603ca1",
+    ".duaer/templates/tasks-template.md": "fc29a233f6f5a27ca31f1aa46b596af6500c627441c6e62b2bc4a1d721525842",
+    ".duaer/templates/spec-template.md": "3945437fc35cd30a5b2bf7beea680337c3516826d3efa5a6b92c4a7eca1ba28e",
+    ".duaer/templates/plan-template.md": "7e637502d41eccf0ca672496636365691fdca62ef37b27ec07fcb412dbfa90d4",
+    ".duaer/.gitignore": "8c908410d177a1ef3d0dee16d7ad55f2ac3333df3104c4d4adee1c9b82f1dbc1"
+  }
+}

package/.duaer/memory/.constitution-template.json

@@ -0,0 +1,4 @@
+{
+  "sha256": "ce7549540fa45543cca797a150201d868e64495fdff39dc38246fb17bd4024b3",
+  "source": "core"
+}

package/.duaer/memory/constitution.md

@@ -0,0 +1,37 @@
+# Project Constitution (template)
+
+Replace this file per project. Keep it short and enforceable.
+
+Part of **duaer-spec**. If the host repo's `AGENTS.md` conflicts with this
+constitution on isolation, commits, or Issue/PR gates, follow `AGENTS.md`; keep
+Duaer for what to build.
+
+## Core Principles
+
+### I. Spec before code (NON-NEGOTIABLE)
+
+Features, architecture changes, and hotfixes start with a Duaer feature
+artifact before implementation. Default path:
+
+`constitution` → `specify` → (optional `clarify`) → `plan` → (optional `checklist` / `analyze`) → `tasks` → `implement` → `converge`
+
+Hotfix may shorten to: `specify` (mark hotfix) → `tasks` → `implement` → `converge`.
+Never skip `specify` or `converge`.
+
+### II. Read as-is before changing
+
+Before any feature work, read:
+
+1. This constitution
+2. `.duaer/memory/project-context.md` (implementation truth)
+3. Project product intent doc (if any)
+
+### III. Smallest coherent change
+
+Prefer the smallest change that satisfies the acceptance criteria in `spec.md`.
+Do not expand scope without updating the spec and tasks.
+
+### IV. Verify before done
+
+Mark tasks complete only when the stated verification (tests, manual checks,
+or converge) has been performed or explicitly waived in the feature docs.

package/.duaer/memory/project-context.md

@@ -0,0 +1,24 @@
+# Project context (as-is)
+
+Fill this in for each project. Agents treat it as implementation truth.
+
+## Stack
+
+- Language / runtime:
+- Package manager:
+- App entrypoints:
+- Test commands:
+
+## Layout
+
+- Source roots:
+- Important packages / apps:
+
+## Non-negotiable boundaries
+
+- Do not:
+- Always:
+
+## Known gotchas
+
+-

package/.duaer/memory/testing.md

@@ -0,0 +1,14 @@
+# Testing expectations (template)
+
+## Levels
+
+- L0: lint / typecheck
+- L1: unit tests for changed modules
+- L2: integration tests for changed boundaries
+- L3: e2e / browser for user-visible paths
+- L4: manual account verification when UI or auth is involved
+
+## Default for features
+
+Specs and `tasks.md` must include verification tasks. Prefer automated checks;
+document any manual step that cannot be automated.