project-init 0.3.0__py3-none-any.whl

project_init/templates/base/dot_claude/scripts/create_issue.sh

@@ -0,0 +1,577 @@
+#!/bin/bash
+# Create a GitHub issue with typed labels and planning metadata.
+# Priority, Size, Agent ready, and Confidence are set directly on the
+# GitHub Project v2 board — not written to the issue body.
+#
+# Usage:
+#   .claude/scripts/create_issue.sh <type> "Short description" [metadata flags]
+#
+# Types: feat  fix  chore  docs  test
+#
+# Prints the created issue number to stdout so it can be piped:
+#   .claude/scripts/create_issue.sh feat "Add OAuth login" --priority high | xargs -I{} .claude/scripts/start_issue.sh {} feat
+
+set -euo pipefail
+
+VALID_TYPES="feat fix chore docs test"
+VALID_SCALES="epic task"
+VALID_PRIORITIES="high medium low"
+VALID_SIZES="XS S M L XL"
+VALID_CONFIDENCES="high medium low unknown"
+
+usage() {
+  cat <<'EOF'
+Usage: create_issue.sh <type> "Short description" [options]
+
+Types:
+  feat  fix  chore  docs  test
+
+Options:
+  --priority high|medium|low           Set Priority on the project board
+  --size XS|S|M|L|XL                   Set Size on the project board
+  --agent-ready Yes|No                 Set Agent ready on the project board
+  --confidence high|medium|low|unknown Set Confidence on the project board
+  --area VALUE                         Record affected area in body metadata
+  --scale epic|task                    Mark as epic (parent) or task (leaf); adds scale label
+  --parent VALUE                       Link new issue as sub-issue of VALUE
+                                       Formats: 42, #42, owner/repo#42, or full issue URL
+  --reference VALUE                    Add a reference; repeatable
+  --dependency VALUE                   Add a dependency; repeatable
+  --acceptance VALUE                   Add an acceptance criterion; repeatable
+  --assignee USER                      Assign the issue
+  --milestone NAME                     Set milestone by name
+  --body-file FILE                     Append extra markdown body content
+  -h, --help                           Show this help
+
+Sub-issues:
+  --parent links the new issue as a native GitHub sub-issue of the given parent.
+  Cross-repo parents use owner/repo#42 or the full issue URL.
+  --scale epic marks this issue as a parent work item (adds scale:epic label).
+
+Metadata model:
+  GitHub labels: type and scale when labels exist or can be created.
+  GitHub Project fields: priority, size, agent-ready, confidence (set directly via GraphQL).
+  Markdown body: area, scale, parent, references, dependencies, acceptance criteria,
+  Definition of Ready, and Definition of Done.
+
+Missing label fallback:
+  If a label is missing and cannot be created, issue creation continues without
+  that label because the same metadata is still stored in the markdown body.
+EOF
+}
+
+if [ "${1:-}" = "--help" ] || [ "${1:-}" = "-h" ]; then
+  usage
+  exit 0
+fi
+
+if [ $# -lt 2 ]; then
+  usage >&2
+  exit 1
+fi
+
+TYPE="$1"
+DESCRIPTION="$2"
+shift 2
+
+PRIORITY=""
+SIZE=""
+AGENT_READY=""
+CONFIDENCE=""
+AREA=""
+SCALE=""
+PARENT=""
+ASSIGNEE=""
+MILESTONE=""
+BODY_FILE=""
+REFERENCES=()
+DEPENDENCIES=()
+ACCEPTANCE=()
+
+contains_word() {
+  local needle="$1"
+  local haystack="$2"
+  echo "$haystack" | grep -qw "$needle"
+}
+
+require_option_value() {
+  local option="$1"
+  local value="${2:-}"
+  if [ -z "$value" ]; then
+    echo "ERROR: missing value for '$option'" >&2
+    usage >&2
+    exit 1
+  fi
+}
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --priority)
+      require_option_value "$1" "${2:-}"
+      PRIORITY="$2"
+      shift 2
+      ;;
+    --size)
+      require_option_value "$1" "${2:-}"
+      SIZE="$2"
+      shift 2
+      ;;
+    --agent-ready)
+      require_option_value "$1" "${2:-}"
+      AGENT_READY="$2"
+      shift 2
+      ;;
+    --confidence)
+      require_option_value "$1" "${2:-}"
+      CONFIDENCE="$2"
+      shift 2
+      ;;
+    --area)
+      require_option_value "$1" "${2:-}"
+      AREA="$2"
+      shift 2
+      ;;
+    --scale)
+      require_option_value "$1" "${2:-}"
+      SCALE="$2"
+      shift 2
+      ;;
+    --parent)
+      require_option_value "$1" "${2:-}"
+      PARENT="$2"
+      shift 2
+      ;;
+    --reference)
+      require_option_value "$1" "${2:-}"
+      REFERENCES+=("$2")
+      shift 2
+      ;;
+    --dependency)
+      require_option_value "$1" "${2:-}"
+      DEPENDENCIES+=("$2")
+      shift 2
+      ;;
+    --acceptance)
+      require_option_value "$1" "${2:-}"
+      ACCEPTANCE+=("$2")
+      shift 2
+      ;;
+    --assignee)
+      require_option_value "$1" "${2:-}"
+      ASSIGNEE="$2"
+      shift 2
+      ;;
+    --milestone)
+      require_option_value "$1" "${2:-}"
+      MILESTONE="$2"
+      shift 2
+      ;;
+    --body-file)
+      require_option_value "$1" "${2:-}"
+      BODY_FILE="$2"
+      shift 2
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "ERROR: unknown option '$1'" >&2
+      usage >&2
+      exit 1
+      ;;
+  esac
+done
+
+if ! contains_word "$TYPE" "$VALID_TYPES"; then
+  echo "ERROR: invalid type '$TYPE'. Valid types: $VALID_TYPES" >&2
+  exit 1
+fi
+
+if [ -z "$DESCRIPTION" ]; then
+  echo "ERROR: description cannot be empty" >&2
+  exit 1
+fi
+
+if [ -n "$PRIORITY" ] && ! contains_word "$PRIORITY" "$VALID_PRIORITIES"; then
+  echo "ERROR: invalid priority '$PRIORITY'. Valid: $VALID_PRIORITIES" >&2
+  exit 1
+fi
+
+if [ -n "$SIZE" ] && ! contains_word "$SIZE" "$VALID_SIZES"; then
+  echo "ERROR: invalid size '$SIZE'. Valid: $VALID_SIZES" >&2
+  exit 1
+fi
+
+if [ -n "$CONFIDENCE" ] && ! contains_word "$CONFIDENCE" "$VALID_CONFIDENCES"; then
+  echo "ERROR: invalid confidence '$CONFIDENCE'. Valid: $VALID_CONFIDENCES" >&2
+  exit 1
+fi
+
+if [ -n "$SCALE" ] && ! contains_word "$SCALE" "$VALID_SCALES"; then
+  echo "ERROR: invalid scale '$SCALE'. Valid scales: $VALID_SCALES" >&2
+  exit 1
+fi
+
+if [ -n "$BODY_FILE" ] && [ ! -f "$BODY_FILE" ]; then
+  echo "ERROR: body file not found: $BODY_FILE" >&2
+  exit 1
+fi
+
+# ---------------------------------------------------------------------------
+# Parse --parent reference into owner / repo / number.
+# Accepts: 42, #42, owner/repo#42, or full GitHub issue URL.
+# Sets globals PARENT_OWNER, PARENT_REPO, PARENT_NUMBER.
+# ---------------------------------------------------------------------------
+PARENT_OWNER=""
+PARENT_REPO=""
+PARENT_NUMBER=""
+
+parse_parent() {
+  local raw="${1#\#}"   # strip leading #
+  if [[ "$raw" =~ ^https://github\.com/([^/]+)/([^/]+)/issues/([0-9]+)$ ]]; then
+    PARENT_OWNER="${BASH_REMATCH[1]}"
+    PARENT_REPO="${BASH_REMATCH[2]}"
+    PARENT_NUMBER="${BASH_REMATCH[3]}"
+  elif [[ "$raw" =~ ^([^/#]+)/([^#]+)#([0-9]+)$ ]]; then
+    PARENT_OWNER="${BASH_REMATCH[1]}"
+    PARENT_REPO="${BASH_REMATCH[2]}"
+    PARENT_NUMBER="${BASH_REMATCH[3]}"
+  elif [[ "$raw" =~ ^[0-9]+$ ]]; then
+    PARENT_OWNER=$(gh repo view --json owner -q .owner.login)
+    PARENT_REPO=$(gh repo view --json name -q .name)
+    PARENT_NUMBER="$raw"
+  else
+    echo "ERROR: cannot parse parent '$1'. Use: 42, #42, owner/repo#42, or full URL" >&2
+    exit 1
+  fi
+}
+
+if [ -n "$PARENT" ]; then
+  parse_parent "$PARENT"
+fi
+
+case "$TYPE" in
+  feat)  TYPE_LABEL="feature" ;;
+  fix)   TYPE_LABEL="bug" ;;
+  chore) TYPE_LABEL="chore" ;;
+  docs)  TYPE_LABEL="documentation" ;;
+  test)  TYPE_LABEL="test" ;;
+esac
+
+TITLE="$DESCRIPTION"
+
+BODY_PATH=$(mktemp)
+trap 'rm -f "$BODY_PATH"' EXIT
+
+write_list() {
+  local fallback="$1"
+  shift
+  if [ "$#" -eq 0 ]; then
+    echo "- [ ] $fallback"
+    return
+  fi
+  for item in "$@"; do
+    [ -n "$item" ] && echo "- [ ] $item"
+  done
+}
+
+write_bullets() {
+  local fallback="$1"
+  shift
+  if [ "$#" -eq 0 ]; then
+    echo "- $fallback"
+    return
+  fi
+  for item in "$@"; do
+    [ -n "$item" ] && echo "- $item"
+  done
+}
+
+{
+  echo "## Summary"
+  echo
+  echo "$DESCRIPTION"
+  echo
+  echo "## Metadata"
+  echo
+  echo "- Type: $TYPE"
+  [ -n "$SCALE" ] && echo "- Scale: $SCALE"
+  [ -n "$AREA" ] && echo "- Area: $AREA"
+  if [ -n "$PARENT" ]; then
+    echo "- Parent: $PARENT_OWNER/$PARENT_REPO#$PARENT_NUMBER"
+  fi
+  if [ -n "$ASSIGNEE" ]; then
+    echo "- Assignee: @$ASSIGNEE"
+  fi
+  if [ -n "$MILESTONE" ]; then
+    echo "- Milestone: $MILESTONE"
+  fi
+  if [ "${#REFERENCES[@]}" -gt 0 ]; then
+    echo
+    echo "## References"
+    echo
+    write_bullets "None" "${REFERENCES[@]}"
+  fi
+  if [ "${#DEPENDENCIES[@]}" -gt 0 ]; then
+    echo
+    echo "## Dependencies"
+    echo
+    write_bullets "None" "${DEPENDENCIES[@]}"
+  fi
+  echo
+  echo "## Acceptance criteria"
+  echo
+  write_list "Define acceptance criteria before implementation" "${ACCEPTANCE[@]}"
+  echo
+  echo "## Definition of Ready"
+  echo
+  echo "- [ ] Acceptance criteria are clear enough to verify"
+  echo "- [ ] Dependencies, references, and affected areas are recorded"
+  echo
+  echo "## Definition of Done"
+  echo
+  echo "- [ ] Implementation is complete"
+  echo "- [ ] Relevant checks, tests, or manual validation are documented"
+} > "$BODY_PATH"
+
+if [ -n "$BODY_FILE" ]; then
+  {
+    echo
+    echo "## Additional context"
+    echo
+    cat "$BODY_FILE"
+  } >> "$BODY_PATH"
+fi
+
+ensure_label() {
+  local name="$1"
+  local color="$2"
+  local description="$3"
+  if gh label list --search "$name" --json name -q '.[].name' 2>/dev/null | grep -Fxq "$name"; then
+    echo "$name"
+    return
+  fi
+  if gh label create "$name" --color "$color" --description "$description" >/dev/null 2>&1; then
+    echo "$name"
+    return
+  fi
+  echo "Warning: label missing and could not be created: $name" >&2
+}
+
+LABEL_ARGS=()
+if LABEL=$(ensure_label "$TYPE_LABEL" "0075ca" "Issue type"); then
+  [ -n "$LABEL" ] && LABEL_ARGS+=(--label "$LABEL")
+fi
+if [ -n "$SCALE" ]; then
+  if LABEL=$(ensure_label "scale:$SCALE" "f9d0c4" "Issue scale"); then
+    [ -n "$LABEL" ] && LABEL_ARGS+=(--label "$LABEL")
+  fi
+fi
+
+CREATE_ARGS=(--title "$TITLE" --body-file "$BODY_PATH")
+if [ -n "$ASSIGNEE" ]; then
+  CREATE_ARGS+=(--assignee "$ASSIGNEE")
+fi
+if [ -n "$MILESTONE" ]; then
+  CREATE_ARGS+=(--milestone "$MILESTONE")
+fi
+
+ISSUE_URL=$(gh issue create "${CREATE_ARGS[@]}" "${LABEL_ARGS[@]}")
+ISSUE_NUMBER=$(echo "$ISSUE_URL" | grep -oE '[0-9]+$')
+
+# ---------------------------------------------------------------------------
+# Set Priority / Size / Agent ready / Confidence directly on the GitHub
+# Project v2 board. These are not written to the issue body — the board is
+# the authoritative location for these fields.
+# PROJECT_NUMBER defaults to 1; override with the env var if needed.
+# ---------------------------------------------------------------------------
+sync_project_fields() {
+  local issue_num="$1"
+  local project_num owner repo_name project_data project_id item_id
+
+  project_num="${PROJECT_NUMBER:-1}"
+  owner=$(gh repo view --json owner -q .owner.login)
+  repo_name=$(gh repo view --json name -q .name)
+
+  project_data=$(gh api graphql -f query='
+    query($owner: String!, $number: Int!) {
+      user(login: $owner) {
+        projectV2(number: $number) {
+          id
+          fields(first: 50) {
+            nodes {
+              ... on ProjectV2SingleSelectField {
+                id name options { id name }
+              }
+            }
+          }
+          items(first: 100) {
+            nodes { id content { ... on Issue { number } } }
+          }
+        }
+      }
+      organization(login: $owner) {
+        projectV2(number: $number) {
+          id
+          fields(first: 50) {
+            nodes {
+              ... on ProjectV2SingleSelectField {
+                id name options { id name }
+              }
+            }
+          }
+          items(first: 100) {
+            nodes { id content { ... on Issue { number } } }
+          }
+        }
+      }
+    }' -f owner="$owner" -F number="$project_num" 2>/dev/null) || true
+  [ -z "$project_data" ] && project_data='{}'
+
+  # Write project data to a temp file to avoid single-quote issues in shell args
+  local pdata_file
+  pdata_file=$(mktemp)
+  printf '%s' "$project_data" > "$pdata_file"
+
+  project_id=$(python3 - "$pdata_file" <<'PYEOF' 2>/dev/null || true
+import sys, json
+d = json.load(open(sys.argv[1])).get('data', {})
+p = (d.get('user') or d.get('organization') or {}).get('projectV2') or {}
+print(p.get('id', ''))
+PYEOF
+)
+
+  if [ -z "$project_id" ]; then
+    rm -f "$pdata_file"
+    echo "Warning: project #$project_num not found — skipping field sync (set PROJECT_NUMBER if needed)" >&2
+    return 0
+  fi
+
+  item_id=$(python3 - "$pdata_file" "$issue_num" <<'PYEOF' 2>/dev/null || true
+import sys, json
+d = json.load(open(sys.argv[1])).get('data', {})
+p = (d.get('user') or d.get('organization') or {}).get('projectV2') or {}
+for item in (p.get('items') or {}).get('nodes', []):
+    if (item.get('content') or {}).get('number') == int(sys.argv[2]):
+        print(item['id'])
+        break
+PYEOF
+)
+
+  if [ -z "$item_id" ]; then
+    local issue_node_id
+    issue_node_id=$(gh api "repos/$owner/$repo_name/issues/$issue_num" --jq '.node_id' 2>/dev/null || true)
+    if [ -n "$issue_node_id" ]; then
+      item_id=$(gh api graphql -f query='
+        mutation($project: ID!, $content: ID!) {
+          addProjectV2ItemById(input: { projectId: $project, contentId: $content }) {
+            item { id }
+          }
+        }' -f project="$project_id" -f content="$issue_node_id" \
+        --jq '.data.addProjectV2ItemById.item.id' 2>/dev/null || true)
+    fi
+  fi
+
+  if [ -z "$item_id" ]; then
+    echo "Warning: could not add #$issue_num to project #$project_num — skipping field sync" >&2
+    return 0
+  fi
+
+  set_field() {
+    local field_name="$1" option_name="$2"
+    [ -n "$option_name" ] || return 0
+
+    local field_id option_id
+    field_id=$(python3 - "$pdata_file" "$field_name" <<'PYEOF' 2>/dev/null || true
+import sys, json
+d = json.load(open(sys.argv[1])).get('data', {})
+p = (d.get('user') or d.get('organization') or {}).get('projectV2') or {}
+for f in (p.get('fields') or {}).get('nodes', []):
+    if f.get('name') == sys.argv[2]:
+        print(f.get('id', ''))
+        break
+PYEOF
+)
+
+    if [ -z "$field_id" ]; then
+      echo "Warning: project field '$field_name' not found — skipping" >&2
+      return 0
+    fi
+
+    option_id=$(python3 - "$pdata_file" "$field_name" "$option_name" <<'PYEOF' 2>/dev/null || true
+import sys, json
+d = json.load(open(sys.argv[1])).get('data', {})
+p = (d.get('user') or d.get('organization') or {}).get('projectV2') or {}
+for f in (p.get('fields') or {}).get('nodes', []):
+    if f.get('name') == sys.argv[2]:
+        for opt in f.get('options', []):
+            if opt.get('name') == sys.argv[3]:
+                print(opt['id'])
+                break
+        break
+PYEOF
+)
+
+    if [ -z "$option_id" ]; then
+      echo "Warning: option '$option_name' not found in field '$field_name' — skipping" >&2
+      return 0
+    fi
+
+    gh api graphql -f query='
+      mutation($project: ID!, $item: ID!, $field: ID!, $option: String!) {
+        updateProjectV2ItemFieldValue(input: {
+          projectId: $project
+          itemId: $item
+          fieldId: $field
+          value: { singleSelectOptionId: $option }
+        }) { projectV2Item { id } }
+      }' \
+      -f project="$project_id" -f item="$item_id" \
+      -f field="$field_id" -f option="$option_id" > /dev/null 2>&1 \
+      || echo "Warning: failed to set '$field_name'='$option_name'" >&2
+  }
+
+  [ -n "$PRIORITY" ]    && set_field "Priority"    "$PRIORITY"
+  [ -n "$SIZE" ]        && set_field "Size"         "$SIZE"
+  [ -n "$AGENT_READY" ] && set_field "Agent ready"  "$AGENT_READY"
+  [ -n "$CONFIDENCE" ]  && set_field "Confidence"   "$CONFIDENCE"
+  rm -f "$pdata_file"
+}
+
+if [ -n "$PRIORITY" ] || [ -n "$SIZE" ] || [ -n "$AGENT_READY" ] || [ -n "$CONFIDENCE" ]; then
+  sync_project_fields "$ISSUE_NUMBER"
+fi
+
+# ---------------------------------------------------------------------------
+# Link as a native GitHub sub-issue when --parent was specified.
+# Uses the addSubIssue GraphQL mutation (supports cross-repo parents via URL).
+# ---------------------------------------------------------------------------
+if [ -n "$PARENT" ]; then
+  PARENT_NODE_ID=$(gh api graphql -f query='
+    query($owner: String!, $repo: String!, $number: Int!) {
+      repository(owner: $owner, name: $repo) {
+        issue(number: $number) { id }
+      }
+    }' \
+    -f owner="$PARENT_OWNER" \
+    -f repo="$PARENT_REPO" \
+    -F number="$PARENT_NUMBER" \
+    --jq '.data.repository.issue.id')
+
+  CHILD_NODE_ID=$(gh api "repos/:owner/:repo/issues/$ISSUE_NUMBER" --jq '.node_id')
+
+  gh api graphql -f query='
+    mutation($parent: ID!, $child: ID!) {
+      addSubIssue(input: { issueId: $parent, subIssueId: $child }) {
+        issue { number }
+        subIssue { number }
+      }
+    }' \
+    -f parent="$PARENT_NODE_ID" \
+    -f child="$CHILD_NODE_ID" > /dev/null
+
+  echo "Linked #$ISSUE_NUMBER as sub-issue of $PARENT_OWNER/$PARENT_REPO#$PARENT_NUMBER" >&2
+fi
+
+echo "$ISSUE_NUMBER"

project_init/templates/base/dot_claude/scripts/create_nojira_pr.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+# Thin shim — actual logic lives in .claude/hooks/dag_workflow.py.
+exec python3 "$(dirname "$0")/../hooks/dag_workflow.py" create-pr-nojira "$@"

project_init/templates/base/dot_claude/scripts/finish_pr.sh

@@ -0,0 +1,3 @@
+#!/bin/bash
+# Thin shim — actual logic lives in .claude/hooks/dag_workflow.py.
+exec python3 "$(dirname "$0")/../hooks/dag_workflow.py" finish "$@"

project_init/templates/base/dot_claude/scripts/install_hooks.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# Install git hooks from .github/hooks/ to .git/hooks/
+# Run this once after cloning or when hooks are updated
+
+set -e
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
+GIT_HOOKS_SRC="$REPO_ROOT/.github/hooks"
+GIT_HOOKS_DST="$REPO_ROOT/.git/hooks"
+
+if [ ! -d "$GIT_HOOKS_DST" ]; then
+  echo "Error: .git/hooks directory not found. Are you in a git repository?"
+  exit 1
+fi
+
+if [ ! -d "$GIT_HOOKS_SRC" ]; then
+  echo "Warning: .github/hooks directory not found."
+  exit 0
+fi
+
+echo "Installing git hooks from .github/hooks/ to .git/hooks/..."
+
+for hook_file in "$GIT_HOOKS_SRC"/*; do
+  [ -f "$hook_file" ] || continue
+
+  hook_name=$(basename "$hook_file")
+  hook_dst="$GIT_HOOKS_DST/$hook_name"
+
+  if [ -e "$hook_dst" ] && [ ! -L "$hook_dst" ]; then
+    # File exists and is not a symlink - back it up
+    mv "$hook_dst" "$hook_dst.backup.$(date +%s)"
+    echo "  Backed up existing $hook_name"
+  fi
+
+  # Create symlink (or copy if symlinks not available)
+  if cp -P "$hook_file" "$hook_dst" 2>/dev/null; then
+    chmod +x "$hook_dst"
+  else
+    echo "  ✗ Failed to install $hook_name"
+    exit 1
+  fi
+done
+
+# The pre-commit hook scans staged changes with gitleaks (ADR-007).
+# It fails open when gitleaks is missing — CI is the hard backstop — but
+# local feedback is much faster, so nudge here.
+if ! command -v gitleaks >/dev/null 2>&1; then
+  echo ""
+  echo "NOTE: gitleaks is not installed — the pre-commit secret scan will be"
+  echo "skipped locally (CI still scans). Install it for fast local feedback:"
+  echo "  https://github.com/gitleaks/gitleaks#installing"
+fi
+
+echo "To reinstall hooks after pulling changes, run:"
+echo "  .claude/scripts/install_hooks.sh"