redup/worktree-guard.yaml at main · semcod/redup · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
schema: wellmanifest.worktree-guard/v1
pipeline:
  name: worktree-overlap-guard
  description: >
    Fail closed when two or more worktrees of the same repository identity
    change the same paths, or when IN_PROGRESS intents overlap without
    conflictsWith. Companion to workspace_lifecycle_check.py (terminal cleanup)
    and to pyqual.yaml / goal.yaml style enforcement.

  detect:
    min_worktrees: 2
    same_identity: true
    workspace_roots:
      - .
      - worktrees
      - .worktrees
      - ../.worktrees

  compare:
    git: true
    intents: true
    code2llm: optional

  ignore:
    - TODO.md
    - project/TICKETS.md
    - project/ticket-*/**
    - node_modules/**
    - .venv/**
    - venv/**
    - __pycache__/**

  enforce:
    on_overlap: fail_closed
    require_conflictsWith: true

  triggers:
    - kind: once
    - kind: interval
      seconds: 300
    - kind: worktree-change
    - kind: pre-commit
    - kind: governance-check
    - kind: systemd-timer
      seconds: 300
    - kind: systemd-path

  command: python3 scripts/worktree_overlap_check.py --workspace-root {workdir}

# Install (see docs/WORKTREE_GUARD.md):
#   per repository   ./scripts/install-worktree-guard.sh --target <repo> --pyqual <repo>/pyqual.yaml
#   per workspace    ./scripts/install-worktree-guard.sh --workspace <org-dir> --interval 300 --enable
#
# Optional pyqual.yaml snippet, also printed by
# `python3 scripts/worktree_guard.py --print-pyqual-stage`:
#
# custom_tools:
#   - name: worktree_guard
#     binary: python3
#     command: python3 .governance/worktree_guard.py --root {workdir} --once
#     allow_failure: false
# stages:
#   - name: worktree-overlap
#     tool: worktree_guard
#     optional: false