fix: shellcheck warnings for Nix writeShellApplication

- Remove unused SCRIPT_DIR (SC2034) - Split local var= declaration from assignment (SC2155) - Replace &&/|| with if/else in cmd_clean (SC2015) - Add shellcheck disable for .venv source (SC1091)
dev-orchestrator: decouple spec scaffold from fill, delegate exploration to OpenSpec native /opsx commands
2026-08-05 10:46:52 -03:00 · 2026-08-05 10:43:35 -03:00 · 2026-08-04 18:41:40 -03:00 · 2026-08-04 18:26:08 -03:00 · 2026-08-04 18:24:29 -03:00
24 changed files with 64 additions and 1169 deletions
@@ -29,11 +29,11 @@
        ]
      },
      "locked": {
-        "lastModified": 1782949081,
-        "narHash": "sha256-vp6Y/Grm98ESt6ceOkWiHWyZRDV3J1RID4w+6NWK9yA=",
+        "lastModified": 1772408722,
+        "narHash": "sha256-rHuJtdcOjK7rAHpHphUb1iCvgkU3GpfvicLMwwnfMT0=",
        "owner": "hercules-ci",
        "repo": "flake-parts",
-        "rev": "17c9d6cdfc60c64f4ee8d306f9bc0b4ccb51481e",
+        "rev": "f20dc5d9b8027381c474144ecabc9034d6a839a3",
        "type": "github"
      },
      "original": {
@@ -70,11 +70,11 @@
        "uv2nix": "uv2nix"
      },
      "locked": {
-        "lastModified": 1785872157,
-        "narHash": "sha256-pO67XFTtQ7Y18u9k4UnMmiGwDcmVEZREUDt6IQt1rmQ=",
+        "lastModified": 1784633374,
+        "narHash": "sha256-kaRIIOZwlfLI3dwI5TgnyuLyG5RsuwM6jsuw3s5m5wc=",
        "owner": "NousResearch",
        "repo": "hermes-agent",
-        "rev": "43717123ca1566a073270c5a61431e2e0e4a0211",
+        "rev": "64702f8f91661149128ca1a721f7a0fd4c22113b",
        "type": "github"
      },
      "original": {
@@ -90,11 +90,11 @@
        ]
      },
      "locked": {
-        "lastModified": 1785119570,
-        "narHash": "sha256-Rgs2xKnGLFWQscxUaXX07oyZeuMDOHEbqDOsgliLFGM=",
+        "lastModified": 1783740085,
+        "narHash": "sha256-qajyHfZY29G2oEQk+uHxmsJcRoBUBXP9maTpFlwP/dI=",
        "owner": "nix-community",
        "repo": "home-manager",
-        "rev": "d4fd24667c8cbef124bb70a20380cab75ec8474d",
+        "rev": "3cd22efe6471dc7365c822bd9ad73a21e55f38fb",
        "type": "github"
      },
      "original": {
@@ -111,11 +111,11 @@
        ]
      },
      "locked": {
-        "lastModified": 1785531816,
-        "narHash": "sha256-vkMnV0JIyw+g/NmcfoajlGaAO+9a0ezia+FZohQJrik=",
+        "lastModified": 1783823409,
+        "narHash": "sha256-OI4IkRjRXa1e7hYmCGJDPDq5H/kPwhsyoS80cNUF9fI=",
        "owner": "nix-community",
        "repo": "home-manager",
-        "rev": "bf9ce9fec78f95f374e8dd3b503863a3ec128ebe",
+        "rev": "7566825d4652a1b885bd4ce65bd9e8def432fec9",
        "type": "github"
      },
      "original": {
@@ -132,11 +132,11 @@
        ]
      },
      "locked": {
-        "lastModified": 1785531816,
-        "narHash": "sha256-vkMnV0JIyw+g/NmcfoajlGaAO+9a0ezia+FZohQJrik=",
+        "lastModified": 1782839684,
+        "narHash": "sha256-vzs4SBgPsK4aNzlJR2PpFwtARazXMOxZonQnDz0YHxk=",
        "owner": "nix-community",
        "repo": "home-manager",
-        "rev": "bf9ce9fec78f95f374e8dd3b503863a3ec128ebe",
+        "rev": "2a37d71bbe69e1522ddabf03a4cea0374958bdbe",
        "type": "github"
      },
      "original": {
@@ -147,11 +147,11 @@
    },
    "nixpkgs": {
      "locked": {
-        "lastModified": 1785318670,
-        "narHash": "sha256-dN6Ou5x/+23FZLEpYP3IffO+NyJFzUlGumt1uu3MMaY=",
+        "lastModified": 1775036866,
+        "narHash": "sha256-ZojAnPuCdy657PbTq5V0Y+AHKhZAIwSIT2cb8UgAz/U=",
        "owner": "NixOS",
        "repo": "nixpkgs",
-        "rev": "0954f7ee2f6bb3dc7d4e3d0d8bcb8fd4bde4cfc5",
+        "rev": "6201e203d09599479a3b3450ed24fa81537ebc4e",
        "type": "github"
      },
      "original": {
@@ -163,11 +163,11 @@
    },
    "nixpkgs-deck": {
      "locked": {
-        "lastModified": 1785828668,
-        "narHash": "sha256-8fsyqeO+mJqvIzeO4xIpgJe/f7MTbbVTEC6RT6WSXNs=",
+        "lastModified": 1783776592,
+        "narHash": "sha256-UgCQzxeWI75XM8G+hPrPh+MKzEPjG3SpAj7dtqSbksA=",
        "owner": "NixOS",
        "repo": "nixpkgs",
-        "rev": "e72e4f299401a3689d4b3d5fc6496b11db7064eb",
+        "rev": "e7a3ca8092b61ff85b6a45bf863ea2b2d6a661b3",
        "type": "github"
      },
      "original": {
@@ -179,11 +179,11 @@
    },
    "nixpkgs_2": {
      "locked": {
-        "lastModified": 1785734586,
-        "narHash": "sha256-ODZkEK9Gy50yg6h98u7KkitZ3oc/uuTFK00bh1CRdNA=",
+        "lastModified": 1783703440,
+        "narHash": "sha256-O3/YajjWo001VUIgD8BwaRdSNLUFe7nZ1qV5TwhRBcw=",
        "owner": "NixOS",
        "repo": "nixpkgs",
-        "rev": "531670d871c0e29724a02f3cbcac170adc65b58c",
+        "rev": "8f0500b9660505dc3cb647775fe9a978a74b5283",
        "type": "github"
      },
      "original": {
@@ -230,11 +230,11 @@
        ]
      },
      "locked": {
-        "lastModified": 1785115949,
-        "narHash": "sha256-8AM37BfyGaL2v/SZyg4PupRxJ01Y4htvM+WrTjWrPpo=",
+        "lastModified": 1772555609,
+        "narHash": "sha256-3BA3HnUvJSbHJAlJj6XSy0Jmu7RyP2gyB/0fL7XuEDo=",
        "owner": "pyproject-nix",
        "repo": "build-system-pkgs",
-        "rev": "62c0d86027edb1c4f39a5facc09876348144f7c9",
+        "rev": "c37f66a953535c394244888598947679af231863",
        "type": "github"
      },
      "original": {
@@ -251,11 +251,11 @@
        ]
      },
      "locked": {
-        "lastModified": 1784591072,
-        "narHash": "sha256-zP/WaDxrRu8GANZM61+V2LT/7ycEEdoyLWn7M6WzU7M=",
+        "lastModified": 1772865871,
+        "narHash": "sha256-/ZTSg97aouL0SlPHaokA4r3iuH9QzHVuWPACD2CUCFY=",
        "owner": "pyproject-nix",
        "repo": "pyproject.nix",
-        "rev": "e3b599ca2e7fcf93d4edf65d7f19bbf6491724f3",
+        "rev": "e537db02e72d553cea470976b9733581bcf5b3ed",
        "type": "github"
      },
      "original": {
@@ -302,11 +302,11 @@
        ]
      },
      "locked": {
-        "lastModified": 1785277507,
-        "narHash": "sha256-9Tq3UDX2hD/aveW/HvkBlAmEwJTOlY5HQXJM+L5BGmE=",
+        "lastModified": 1773039484,
+        "narHash": "sha256-+boo33KYkJDw9KItpeEXXv8+65f7hHv/earxpcyzQ0I=",
        "owner": "pyproject-nix",
        "repo": "uv2nix",
-        "rev": "5a836d395cbf5fc22670eb98dd4aa4fc4d406977",
+        "rev": "b68be7cfeacbed9a3fa38a2b5adc0cfb81d9bb1f",
        "type": "github"
      },
      "original": {
@@ -323,11 +323,11 @@
        ]
      },
      "locked": {
-        "lastModified": 1785830592,
-        "narHash": "sha256-4lqvnaiXkjbMCYUkgDqkkPaD40ln0r0bCIz5pGu17EU=",
+        "lastModified": 1783866614,
+        "narHash": "sha256-o2h5BfVz9MPIERBPVHtvQGilphtNn5+cCuqqfY5Lkq8=",
        "owner": "0xc000022070",
        "repo": "zen-browser-flake",
-        "rev": "3eb64fada36de0780703158ef9b1063ba697c24a",
+        "rev": "51602966429e8ccae61324e56b51c37308d1b64e",
        "type": "github"
      },
      "original": {
@@ -27,7 +27,6 @@
    ../../modules/home-manager/opencode
    ../../modules/home-manager/cedilla
    ../../modules/home-manager/dictation
-    ../../modules/home-manager/gif-recorder
    ../../modules/home-manager/nvim
    ../../modules/home-manager/pi
    ../../modules/home-manager/tmux
@@ -38,7 +37,6 @@
    ../../modules/home-manager/pinentry
    ../../modules/home-manager/swaync
    ../../modules/home-manager/bitwarden-cli
-    ../../modules/home-manager/alarms-timers

    inputs.zen-browser.homeModules.beta
  ];
@@ -90,7 +88,6 @@
      enable = true;
      modelHash = "sha256-ZNGCtEC5jVIDxPm9VBVE2ExgUZbE97hF36EfsjWU0eI=";
    };
-    gif-recorder.enable = true;

    nvim.enable = true;
    pi.enable = true;
@@ -100,25 +97,8 @@
    openspec.enable = true;
    dev-orchestrator.enable = true;
    power-profiles.enable = true;
-    ntfy-notify = {
-      enable = true;
-      server = "https://ntfy.joaoporta.com";
-      subscriptions = [
-        {
-          priority = "normal";
-          topic = "music-download";
-          title = "Music Downloaded";
-        }
-        {
-          priority = "critical";
-          topic = "joao-kanban";
-          title = "Kanban Update";
-        }
-      ];
-
-    };
+    ntfy-notify.enable = true;
    bitwarden.enable = true;
-    alarms-timers.enable = true;
  };
  home.packages =
    let
@@ -137,9 +117,6 @@
      nodejs
      firefox
      telegram-desktop
-      koreader
-      xorg.xauth
-      easyeffects
    ];

  programs = {
@@ -17,7 +17,7 @@
      enable = true;
      settings = {
        font = {
-          size = 11;
+          size = 12;
          normal = {
            family = "BerkeleyMono Nerd Font Mono";
            style = "Regular";
@@ -1,210 +0,0 @@
-{
-  config,
-  lib,
-  pkgs,
-  ...
-}:
-let
-  cfg = config.custom.alarms-timers;
-  runtime = pkgs.writeShellScriptBin "alarm-runtime" ''
-    set -efu
-
-    state_dir="''${XDG_STATE_HOME:-$HOME/.local/state}/alarm"
-    state_file="$state_dir/events.json"
-    lock_file="$state_dir/events.lock"
-    mkdir -p "$state_dir"
-
-    init_state() {
-      if [ ! -s "$state_file" ] || ! jq -e '(.nextId | numbers) and (.events | arrays)' "$state_file" >/dev/null 2>&1; then
-        printf '%s\n' '{"nextId":1,"events":[]}' > "$state_file"
-      fi
-    }
-
-    write_state() {
-      tmp=$(mktemp "$state_dir/events.XXXXXX")
-      jq -c . > "$tmp"
-      mv -f "$tmp" "$state_file"
-    }
-
-    usage() {
-      printf '%s\n' "usage: timer DURATION|list|cancel ID" "       alarm [YYYY-MM-DD] HH:MM [DESCRIPTION...]" >&2
-      exit 2
-    }
-
-    die() {
-      printf 'alarm: %s\n' "$1" >&2
-      exit 2
-    }
-
-    parse_duration() {
-      [ -n "$1" ] && [[ "$1" != *[!0-9smh]* ]] || return 1
-      value=''${1%[smh]}
-      unit=''${1#''${value}}
-      [ -n "$value" ] && [ "$value" -gt 0 ] || return 1
-      case "$unit" in s) printf '%s\n' "$value" ;; m) printf '%s\n' "$((value * 60))" ;; h) printf '%s\n' "$((value * 3600))" ;; *) return 1 ;; esac
-    }
-
-    valid_time() { [[ "$1" =~ ^([01][0-9]|2[0-3]):[0-5][0-9]$ ]]; }
-    valid_date() { [[ "$1" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]]; }
-
-    create_timer() {
-      seconds=$(parse_duration "$1") || die "duration must be a positive number followed by s, m, or h"
-      now=$(date +%s)
-      (
-        flock -x 9
-        init_state
-        id=$(jq -r '.nextId' "$state_file")
-        jq --argjson id "$id" --argjson due "$((now + seconds))" \
-          '.nextId = ($id + 1) | .events += [{id:$id,kind:"timer",due:$due,description:null}]' \
-          "$state_file" | write_state
-        printf '%s\n' "$id"
-      ) 9>"$lock_file"
-    }
-
-    create_alarm() {
-      if valid_date "$1"; then
-        [ "$#" -ge 2 ] || usage
-        alarm_date=$1; alarm_time=$2; shift 2
-        valid_time "$alarm_time" || die "time must use HH:MM"
-      else
-        alarm_date=$(date +%F); alarm_time=$1; shift
-        valid_time "$alarm_time" || die "time must use HH:MM"
-        candidate=$(date -d "$alarm_date $alarm_time" +%s) || die "invalid local time"
-        [ "$candidate" -gt "$(date +%s)" ] || alarm_date=$(date -d tomorrow +%F)
-      fi
-      candidate=$(date -d "$alarm_date $alarm_time" +%s) || die "invalid date or time"
-      [ "$(date -d "@$candidate" +%F\ %H:%M)" = "$alarm_date $alarm_time" ] || die "invalid date or time"
-      [ "$candidate" -gt "$(date +%s)" ] || die "explicit alarm date is in the past"
-      description="$*"
-      (
-        flock -x 9
-        init_state
-        if jq -e --argjson due "$candidate" '.events[] | select(.kind == "alarm" and .due == $due)' "$state_file" >/dev/null; then
-          die "an alarm already exists at that time"
-        fi
-        id=$(jq -r '.nextId' "$state_file")
-        jq --argjson id "$id" --argjson due "$candidate" --arg description "$description" \
-          '.nextId = ($id + 1) | .events += [{id:$id,kind:"alarm",due:$due,description:(if $description == "" then null else $description end)}]' \
-          "$state_file" | write_state
-        printf '%s\n' "$id"
-      ) 9>"$lock_file"
-    }
-
-    list_events() {
-      kind=$1
-      (
-        flock -s 9
-        init_state
-        if ! jq -e --arg kind "$kind" '.events | map(select(.kind == $kind)) | length > 0' "$state_file" >/dev/null; then
-          printf 'No %s events scheduled.\n' "$kind"
-          exit 0
-        fi
-        jq -r --arg kind "$kind" '
-          .events | map(select(.kind == $kind)) | sort_by(.due)[] |
-          "\(.id) \(if .kind == "timer" then ("due " + ( .due | todateiso8601)) else ("at " + (.due | strftime("%Y-%m-%d %H:%M"))) end)\(if .description then " - " + .description else "" end)"
-        ' "$state_file"
-      ) 9>"$lock_file"
-    }
-
-    cancel_event() {
-      kind=$1; id=$2
-      [[ "$id" =~ ^[0-9]+$ ]] || die "ID must be numeric"
-      (
-        flock -x 9
-        init_state
-        if ! jq -e --arg kind "$kind" --argjson id "$id" '.events[] | select(.id == $id and .kind == $kind)' "$state_file" >/dev/null; then
-          die "no $kind with ID $id"
-        fi
-        jq --arg kind "$kind" --argjson id "$id" '.events |= map(select(.id != $id or .kind != $kind))' "$state_file" | write_state
-        printf 'Cancelled %s %s.\n' "$kind" "$id"
-      ) 9>"$lock_file"
-    }
-
-    notify_event() {
-      kind=$1; due=$2; description=$3
-      title=$(printf '%s' "$kind" | tr '[:lower:]' '[:upper:]')
-      body="Due $(date -d "@$due" '+%Y-%m-%d %H:%M')"
-      [ -n "$description" ] && body="$body - $description"
-      notify-send -u critical "$title" "$body" || true
-      timeout 1 pw-play "${pkgs.sound-theme-freedesktop}/share/sounds/freedesktop/stereo/alarm-clock-elapsed.oga" >/dev/null 2>&1 || true
-    }
-
-    scheduler() {
-      started=$(date +%s)
-      while :; do
-        now=$(date +%s)
-        event=$(mktemp)
-        (
-          flock -x 9
-          init_state
-          jq --argjson started "$started" --argjson now "$now" \
-            ' .events |= map(select(.due >= $started or .due > $now))' "$state_file" | write_state
-          jq -c --argjson started "$started" --argjson now "$now" \
-            '[.events[] | select(.due >= $started and .due <= $now)] | sort_by(.due) | .[0] // empty' "$state_file" > "$event"
-          if [ -s "$event" ]; then
-            jq --argjson id "$(jq -r .id "$event")" '.events |= map(select(.id != $id))' "$state_file" | write_state
-          fi
-        ) 9>"$lock_file"
-        if [ -s "$event" ]; then
-          kind=$(jq -r .kind "$event"); due=$(jq -r .due "$event"); description=$(jq -r '.description // empty' "$event")
-          rm -f "$event"
-          notify_event "$kind" "$due" "$description"
-        else
-          rm -f "$event"
-        fi
-        sleep 1
-      done
-    }
-
-    waybar() {
-      now=$(date +%s)
-      init_state
-      jq -cn --argjson now "$now" --slurpfile state "$state_file" '
-        ($state[0].events | map(select((.id|numbers) and (.kind == "timer" or .kind == "alarm") and (.due|numbers) and .due >= $now)) | sort_by(.due) | .[0:3]) as $events |
-        {text: ($events | map(if .kind == "timer" then "󰔛 " + (if (.due - $now) < 60 then ((.due - $now)|tostring) else (((.due - $now) / 3600)|floor|tostring|if length < 2 then "0" + . else . end) + ":" + ((((.due - $now) % 3600) / 60)|floor|tostring|if length < 2 then "0" + . else . end) end) else "󰥔 " + (.due | strftime("%H:%M")) end) | join("  ")), tooltip: ($events | map((.kind + " " + (.due | strftime("%Y-%m-%d %H:%M")) + (if .description then " - " + .description else "" end))) | join("\n"))}
-      '
-    }
-
-    command=''${1:-}
-    case "$command" in
-      timer) [ "$#" -ge 2 ] || usage; case "$2" in list) list_events timer ;; cancel) [ "$#" = 3 ] || usage; cancel_event timer "$3" ;; *) [ "$#" = 2 ] || usage; create_timer "$2" ;; esac ;;
-      alarm) [ "$#" -ge 2 ] || usage; case "$2" in list) list_events alarm ;; cancel) [ "$#" = 3 ] || usage; cancel_event alarm "$3" ;; *) create_alarm ''${@:2} ;; esac ;;
-      scheduler) scheduler ;;
-      waybar) waybar ;;
-      *) usage ;;
-    esac
-  '';
-  timer = pkgs.writeShellScriptBin "timer" ''exec ${runtime}/bin/alarm-runtime timer "$@"'';
-  alarm = pkgs.writeShellScriptBin "alarm" ''exec ${runtime}/bin/alarm-runtime alarm "$@"'';
-  scheduler = pkgs.writeShellScriptBin "alarm-scheduler" ''exec ${runtime}/bin/alarm-runtime scheduler'';
-  waybar = pkgs.writeShellScriptBin "alarm-waybar" ''exec ${runtime}/bin/alarm-runtime waybar'';
-in
-{
-  options.custom.alarms-timers.enable = lib.mkEnableOption "terminal alarms and timers";
-
-  config = lib.mkIf cfg.enable {
-    home.packages = [ timer alarm scheduler waybar pkgs.jq pkgs.libnotify pkgs.pipewire pkgs.sound-theme-freedesktop ];
-
-    home.activation.alarmsTimersState = lib.hm.dag.entryAfter [ "writeBoundary" ] ''
-      run mkdir -p "$HOME/.local/state/alarm"
-      if [ ! -s "$HOME/.local/state/alarm/events.json" ]; then
-        run printf '%s\n' '{"nextId":1,"events":[]}' > "$HOME/.local/state/alarm/events.json"
-      fi
-    '';
-
-    systemd.user.services.alarm-scheduler = {
-      Unit = {
-        Description = "Terminal alarm and timer scheduler";
-        After = [ "graphical-session.target" ];
-        PartOf = [ "graphical-session.target" ];
-      };
-      Service = {
-        Type = "simple";
-        ExecStart = "${scheduler}/bin/alarm-scheduler";
-        Restart = "on-failure";
-        RestartSec = 2;
-      };
-      Install.WantedBy = [ "graphical-session.target" ];
-    };
-  };
-}
@@ -3,21 +3,16 @@
  config,
  pkgs,
  ...
-}:
-let
+}: let
  bw = pkgs.writeShellApplication {
    name = "bw";
-    runtimeInputs = with pkgs; [
-      rbw
-      fzf
-      wl-clipboard
-      libnotify
-    ];
+    runtimeInputs = with pkgs; [ rbw fzf wl-clipboard libnotify ];
    text = ''
      set -euo pipefail
      cmd="$(basename "$0")"

-      entry="$(rbw list --fields=id,name,user | fzf --with-nth=2.. --delimiter=$'\t')"
+      entry="$(rbw list --fields=id,name,user --format=tsv \
+        | fzf --with-nth=2.. --delimiter=$'\t')"
      [ -z "$entry" ] && exit 0

      id="$(printf '%s' "$entry" | cut -f1)"
@@ -33,8 +28,7 @@ let
      notify-send -t 1200 "bw: copied $cmd"
    '';
  };
-in
-{
+in {
  options.custom = {
    bitwarden.enable = lib.mkEnableOption "enable bitwarden - CLI password manager";
  };
@@ -51,20 +45,14 @@ in
    };

    home.packages =
-      let
-        mkBin =
-          name:
-          pkgs.symlinkJoin {
-            inherit name;
-            paths = [ bw ];
-            nativeBuildInputs = [ pkgs.makeWrapper ];
-            postBuild = "ln -sf ${bw}/bin/bw $out/bin/${name}";
-          };
+      let mkBin = name:
+        pkgs.symlinkJoin {
+          inherit name;
+          paths = [ bw ];
+          nativeBuildInputs = [ pkgs.makeWrapper ];
+          postBuild = "ln -sf ${bw}/bin/bw $out/bin/${name}";
+        };
      in
-      builtins.map mkBin [
-        "bwp"
-        "bwc"
-        "bwu"
-      ];
+        builtins.map mkBin [ "bwp" "bwc" "bwu" ];
  };
 }
@@ -1,96 +0,0 @@
-{
-  config,
-  lib,
-  pkgs,
-  ...
-}:
-
-let
-  cfg = config.custom.gif-recorder;
-
-  gif-recorder = pkgs.writeShellApplication {
-    name = "gif-recorder";
-    runtimeInputs = with pkgs; [
-      coreutils
-      ffmpeg
-      slurp
-      wf-recorder
-      wl-clipboard
-    ];
-    text = ''
-      runtime_dir="''${XDG_RUNTIME_DIR:-/tmp}"
-      state="$runtime_dir/gif-recorder.pid"
-      selection=""
-      video=""
-      gif_tmp=""
-      child_pid=""
-      stopped=0
-
-      cleanup() {
-        rm -f "$state" "$selection" "$video" "$gif_tmp"
-      }
-
-      stop_child() {
-        stopped=1
-        if [ -n "$child_pid" ]; then
-          kill -INT "$child_pid" 2>/dev/null || true
-        fi
-      }
-
-      trap cleanup EXIT
-      trap stop_child INT TERM
-
-      if [ -f "$state" ]; then
-        active_pid="$(cat "$state" 2>/dev/null || true)"
-        if [ -n "$active_pid" ] && kill -0 "$active_pid" 2>/dev/null; then
-          kill -INT "$active_pid" 2>/dev/null || true
-          exit 0
-        fi
-        rm -f "$state"
-      fi
-
-      echo "$$" > "$state"
-      selection="$(mktemp "$runtime_dir/gif-recorder-selection.XXXXXX")"
-      slurp > "$selection" &
-      child_pid="$!"
-      selection_status=0
-      wait "$child_pid" || selection_status="$?"
-      child_pid=""
-
-      if [ "$stopped" -eq 1 ] || [ "$selection_status" -ne 0 ]; then
-        exit 0
-      fi
-
-      geometry="$(cat "$selection")"
-      video="$(mktemp "$runtime_dir/gif-recorder.XXXXXX.mkv")"
-      wf-recorder --geometry "$geometry" -f "$video" &
-      child_pid="$!"
-      recorder_status=0
-      wait "$child_pid" || recorder_status="$?"
-      child_pid=""
-
-      if [ "$stopped" -ne 1 ] || { [ "$recorder_status" -ne 0 ] && [ "$recorder_status" -ne 130 ]; }; then
-        exit 1
-      fi
-
-      output_dir="$HOME/Pictures/Screenshots"
-      mkdir -p "$output_dir"
-      gif_tmp="$(mktemp "$runtime_dir/gif-recorder.XXXXXX.gif")"
-      ffmpeg -y -i "$video" \
-        -vf 'fps=15,scale=960:-1:flags=lanczos,split[s0][s1];[s0]palettegen=max_colors=256[p];[s1][p]paletteuse=dither=sierra2_4a' \
-        "$gif_tmp"
-
-      output="$output_dir/gif-$(date +%Y%m%d-%H%M%S-%N).gif"
-      mv "$gif_tmp" "$output"
-      gif_tmp=""
-      wl-copy --foreground --type image/gif < "$output" &
-    '';
-  };
-in
-{
-  options.custom.gif-recorder.enable = lib.mkEnableOption "Wayland region GIF recorder";
-
-  config = lib.mkIf cfg.enable {
-    home.packages = [ gif-recorder ];
-  };
-}
@@ -240,7 +240,6 @@ in
            hl.bind(mod_shft .. " + 2", hl.dsp.exec_cmd("hyprshot -m output -m DP-1 -o ~/Pictures/Screenshots"))
            hl.bind(mod_shft .. " + 3", hl.dsp.exec_cmd("hyprshot -m window -m active -o ~/Pictures/Screenshots"))
            hl.bind(mod_shft .. " + 4", hl.dsp.exec_cmd("hyprshot -m region -o ~/Pictures/Screenshots"))
-            hl.bind(mod_shft .. " + 5", hl.dsp.exec_cmd("gif-recorder"))

            -- ---------- OBS Recording ----------
            hl.bind(mod_shft .. " + 9", hl.dsp.exec_cmd("obs-cmd recording toggle"))
@@ -6,16 +6,6 @@
 }:
 let
  cfg = config.custom.ntfy-notify;
-  ntfy-notify = pkgs.writeShellApplication {
-    name = "ntfy-notify-authenticated";
-    runtimeInputs = with pkgs; [ ntfy-sh rbw ];
-    text = ''
-      username="$(rbw get --field username ntfy.joaoporta.com)"
-      password="$(rbw get ntfy.joaoporta.com)"
-      export NTFY_USER="$username:$password"
-      exec ntfy subscribe --from-config
-    '';
-  };
 in
 {
  options.custom.ntfy-notify = {
@@ -34,10 +24,6 @@ in
            type = lib.types.str;
            description = "ntfy topic to subscribe to.";
          };
-          title = lib.mkOption {
-            type = lib.types.str;
-            description = "Notification title for this topic";
-          };
          priority = lib.mkOption {
            type = lib.types.enum [ "low" "normal" "critical" ];
            default = "normal";
@@ -49,7 +35,6 @@ in
        {
          topic = "joao-kanban";
          priority = "critical";
-          title = "Kanban Update";
        }
      ];
      description = ''
@@ -71,7 +56,7 @@ in
        subscribe:
      '' + lib.concatMapStringsSep "\n" (sub:
        let
-          cmd = "${lib.getExe pkgs.libnotify} -a ntfy -u ${sub.priority} \"${sub.title}\" \"$m\"";
+          cmd = "notify-send -a Kanban -u ${sub.priority} \"Kanban Update\" \"$m\"";
        in
        "  - topic: ${cfg.server}/${sub.topic}\n"
        + "    command: ${cmd}"
@@ -86,7 +71,7 @@ in
      };
      Service = {
        Type = "simple";
-        ExecStart = "${ntfy-notify}/bin/ntfy-notify-authenticated";
+        ExecStart = "${pkgs.ntfy-sh}/bin/ntfy subscribe";
        Restart = "on-failure";
        RestartSec = 10;
      };
@@ -124,9 +124,13 @@ return {
 		notes_subdir = "",
 		new_notes_location = "notes_subdir",
 		workspaces = {
+			{
+				name = "personal",
+				path = "~/docs/personal",
+			},
 			{
 				name = "hermes",
-				path = "/mnt/obsidian",
+				path = "/mnt/documents/journal",
 			},
 		},
 		daily_notes = {
@@ -12,7 +12,7 @@
    services.swaync = {
      enable = true;
      settings = {
-        positionX = "center";
+        positionX = "left";
        positionY = "top";
        cssPriority = "user";

@@ -1,2 +0,0 @@
-schema: spec-driven
-created: 2026-07-30
@@ -1,64 +0,0 @@
-## Context
-
-The desktop already uses Home Manager modules under `modules/home-manager` and keeps Hyprland keybinds in `modules/home-manager/hyprland/default.nix`. The new capability is a small user-session workflow, not a daemon: select a region with `slurp`, record it with the Wayland-native `wf-recorder`, encode the result with `ffmpeg`, and publish the finished file with `wl-copy`.
-
-The same Hyprland bind must start and stop the workflow. The first invocation needs to remain alive while recording; a later invocation needs a stable way to find and signal that process. The implementation also needs to avoid leaving partial files in the screenshots directory when selection is cancelled or encoding fails.
-
-## Goals / Non-Goals
-
-**Goals:**
-
- Encapsulate packages, script, option, output directory, and runtime state in `modules/home-manager/gif-recorder`.
- Use a single toggle command suitable for a Hyprland `bind`.
- Select a rectangular region interactively through `slurp`.
- Save optimized GIF output in `~/Pictures/Screenshots` and copy it as `image/gif` with `wl-copy`.
- Keep host wiring minimal: import/enable in `hosts/jpporta-nixos/home.nix`, bind in the existing Hyprland module.
-
-**Non-Goals:**
-
- Full-screen or window recording modes.
- A recording history, notification UI, configurable encoder settings, or a separate stop bind.
- A new service or background daemon.
- Changes to the existing screenshot flow.
-
-## Decisions
-
-### D1. One shell script owns the toggle state
-
-The module installs one `gif-recorder` executable and uses a runtime-directory state file containing the active script PID. If the state file names a live process, a new invocation sends it `SIGINT`; otherwise it runs `slurp` and starts a recording. This keeps the bind to one command and avoids adding a service or IPC layer.
-
-**Alternative:** use separate start/stop scripts or a systemd user service. Rejected because they add commands and lifecycle machinery for one short-lived action.
-
-### D2. Use `wf-recorder`, `slurp`, `ffmpeg`, and `wl-copy`
-
-These tools are small, composable Wayland utilities already suited to the requested flow. `wf-recorder` receives the geometry selected by `slurp`; `ffmpeg` handles palette generation and GIF encoding; `wl-copy --type image/gif` makes the resulting file available to Wayland clipboard consumers.
-
-**Alternative:** OBS or a screenshot/GIF application. Rejected because a GUI recorder is heavier than the requested Hyprshot-like interaction.
-
-### D3. Encode through a temporary video file
-
-Recording first to a temporary Matroska file keeps the output atomic: the final timestamped GIF is moved into `~/Pictures/Screenshots` only after `ffmpeg` succeeds. The encoder uses a palette-generation filter and a bounded frame rate/width to avoid the worst GIF size and color-quality problems without introducing configuration options.
-
-**Alternative:** record directly to GIF. Rejected because palette generation and interruption handling are worse, and `wf-recorder` is designed primarily for video output.
-
-### D4. Store state under `XDG_RUNTIME_DIR`
-
-The state file belongs in `${XDG_RUNTIME_DIR:-/tmp}` and is removed on normal completion or cancellation. It is session-local and avoids polluting the home directory with a lock file.
-
-## Risks / Trade-offs
-
- [GIFs are inherently large and limited to 256 colors] -> Cap output at a modest frame rate and width; keep the original temporary recording out of the screenshots directory.
- [A crashed process can leave a stale state file] -> Check whether the recorded PID is alive before treating the workflow as active, and remove stale state before starting.
- [Clipboard consumers differ in GIF support] -> Publish with the explicit `image/gif` MIME type; the saved file remains the fallback when a consumer cannot paste animated images.
- [The second bind may be pressed while region selection is active] -> Keep the controlling script PID in the state file before invoking `slurp`, and handle interruption by cleaning up without creating output.
-
-## Migration Plan
-
-1. Apply the Home Manager configuration for `jpporta-nixos`.
-2. Press the new Hyprland bind and select a region; press it again to stop and wait for encoding.
-3. Verify the GIF in `~/Pictures/Screenshots` and paste it into a GIF-capable Wayland application.
-4. Roll back by disabling/removing the module import and bind; no persistent data migration is required, and existing GIF files are left untouched.
-
-## Open Questions
-
- The exact key combination should follow the existing screenshot bind convention in the Hyprland module; implementation should reuse that convention rather than introduce a new modifier scheme.
@@ -1,31 +0,0 @@
-## Why
-
-The Hyprland desktop has a screenshot flow but no equally convenient way to capture a short animated region of the screen. A Wayland-native GIF recorder should let the user select a region, press the same bind to stop, and receive the finished GIF in `~/Pictures/Screenshots` and on the clipboard.
-
-## What Changes
-
- Add a new Home Manager module, `modules/home-manager/gif-recorder`, with a single enable option.
- Provide a Wayland-native recording script using `wf-recorder` and `slurp` to select and record a screen region.
- Toggle recording with one Hyprland bind: the first press starts region selection/recording and the next press stops it.
- Convert the recording to an optimized GIF after stopping.
- Save completed GIFs under `~/Pictures/Screenshots` with timestamped filenames.
- Copy the completed GIF to the Wayland clipboard for immediate pasting.
- Enable the module from `hosts/jpporta-nixos/home.nix` and add only the required bind in the existing Hyprland Home Manager module.
-
-## Capabilities
-
-### New Capabilities
-
- `gif-recorder`: Select, toggle-record, save, and clipboard-copy short Wayland screen-region GIFs.
-
-### Modified Capabilities
-
- None.
-
-## Impact
-
- New Home Manager module and user-facing recording script.
- Existing `modules/home-manager/hyprland/default.nix` gains the toggle bind.
- `hosts/jpporta-nixos/home.nix` imports and enables the module.
- Adds the runtime packages `wf-recorder`, `slurp`, `ffmpeg`, and a Wayland clipboard utility through the module.
- Creates `~/Pictures/Screenshots` when a recording is completed; existing screenshot behavior remains unchanged.
@@ -1,49 +0,0 @@
-## ADDED Requirements
-
-### Requirement: Region recording is toggled by one command
-The GIF recorder SHALL use one executable that starts an interactive region recording when idle and stops the active recording when invoked again.
-
-#### Scenario: Start a recording
- **WHEN** the recorder is invoked while no recording is active
- **THEN** it lets the user select a rectangular Wayland region and starts recording that region
-
-#### Scenario: Stop a recording
- **WHEN** the recorder is invoked while a recording is active
- **THEN** it stops the active recording and begins finalization without starting a second recording
-
-#### Scenario: Cancel region selection
- **WHEN** the user cancels region selection before recording starts
- **THEN** the recorder exits without creating a GIF and clears its runtime state
-
-### Requirement: Completed recordings are saved as GIF screenshots
-The recorder SHALL save each successfully finalized recording as a timestamped `.gif` file below `~/Pictures/Screenshots`.
-
-#### Scenario: Successful finalization
- **WHEN** an active recording is stopped and encoding succeeds
- **THEN** the recorder creates the screenshots directory if needed and stores one completed GIF there
-
-#### Scenario: Failed finalization
- **WHEN** recording or GIF encoding fails
- **THEN** the recorder does not publish a partial GIF as a completed screenshot and removes temporary recording data
-
-### Requirement: Completed recordings are copied to the Wayland clipboard
-After successful GIF encoding, the recorder SHALL copy the resulting file to the Wayland clipboard using the `image/gif` MIME type.
-
-#### Scenario: Clipboard copy succeeds
- **WHEN** a GIF is successfully written
- **THEN** the recorder publishes that GIF to the clipboard as `image/gif`
-
-#### Scenario: Clipboard copy is unavailable
- **WHEN** a GIF is successfully written but clipboard publication fails
- **THEN** the recorder preserves the GIF in `~/Pictures/Screenshots` and exits without deleting it
-
-### Requirement: Home Manager integration is opt-in
-The feature SHALL be exposed as a Home Manager module with an enable option, and enabling it SHALL install all required runtime tools and the recorder executable.
-
-#### Scenario: Module enabled
- **WHEN** `custom.gif-recorder.enable` is true
- **THEN** the user environment contains the recorder command and its Wayland recording, selection, encoding, and clipboard dependencies
-
-#### Scenario: Module disabled
- **WHEN** `custom.gif-recorder.enable` is false
- **THEN** the module adds no GIF recorder command, packages, or Hyprland bind
@@ -1,18 +0,0 @@
-## 1. Add the Home Manager module
-
- [x] 1.1 Create `modules/home-manager/gif-recorder/default.nix` with `custom.gif-recorder.enable` and an enabled-only configuration.
- [x] 1.2 Install `wf-recorder`, `slurp`, `ffmpeg`, and `wl-clipboard` through the module and expose one `gif-recorder` script in the user's session path.
- [x] 1.3 Implement the toggle state under `XDG_RUNTIME_DIR`: start region selection/recording when idle, signal the active process on the second invocation, clean up on cancellation/interruption, and reject stale state.
- [x] 1.4 Finalize successful recordings with palette-based `ffmpeg` GIF encoding, timestamp the output below `~/Pictures/Screenshots`, and copy it with `wl-copy --type image/gif` while preserving the saved file if clipboard copy fails.
-
-## 2. Wire the feature into the existing host
-
- [x] 2.1 Import `../../modules/home-manager/gif-recorder` and set `custom.gif-recorder.enable = true` in `hosts/jpporta-nixos/home.nix`.
- [x] 2.2 Add `SUPER + SHIFT + 5` to the existing `Screenshots` section of `modules/home-manager/hyprland/default.nix`, invoking `gif-recorder` so the same bind starts and stops the capture.
-
-## 3. Verify the workflow
-
- [x] 3.1 Evaluate/build the `jpporta-nixos` Home Manager activation package and confirm the module and script parse successfully.
- [x] 3.2 Confirm the bind invokes the installed command and that the runtime dependency paths are available in the script.
- [ ] 3.3 In a live Hyprland session, select a region, stop with the same bind, and verify a timestamped GIF appears in `~/Pictures/Screenshots` and can be pasted from the Wayland clipboard.
- [ ] 3.4 Verify canceling `slurp`, stopping early, and an encoding failure leave no partial GIF and no stale runtime state.
@@ -1,2 +0,0 @@
-schema: spec-driven
-created: 2026-07-31
@@ -1,83 +0,0 @@
-## Context
-
-The desktop runs NixOS with Home Manager, Hyprland, Waybar, SwayNC, and PipeWire. Existing Home Manager modules install shell applications with `writeShellApplication`, define user services, and expose state-backed Waybar scripts. The Waybar layout is maintained separately in `~/dotfiles/waybar/.config/waybar/`; it already has JSON custom modules, a one-second-compatible refresh pattern, and a left-side sequence containing workspaces.
-
-The feature needs one persistent source of truth shared by interactive commands, a scheduler, and Waybar. It must remain local, tolerate concurrent command/scheduler access, and avoid replaying events missed while the machine was unavailable.
-
-## Goals / Non-Goals
-
-**Goals:**
-
- Provide `timer` and `alarm` commands with creation, listing, and ID-based cancellation.
- Persist unlimited events and calculate absolute local wall-clock deadlines.
- Run scheduling as a user service independent of the terminal that created an event.
- Deliver one critical SwayNC notification and one-second PipeWire sound per completed event.
- Provide a reusable Waybar JSON helper showing the three nearest active events.
- Enable the Home Manager module only on `jpporta-nixos` initially.
-
-**Non-Goals:**
-
- Recurring alarms, snooze, pause/resume, labels, graphical management, or click actions.
- A database, network service, system-wide daemon, or cross-host synchronization.
- Managing the complete external dotfiles repository from this Nix repository.
-
-## Decisions
-
-### 1. Use one JSON state file
-
-Store active events and the next numeric ID in `~/.local/state/alarm/events.json`. Each event contains an ID, kind, absolute due timestamp, and optional description. JSON keeps the state inspectable and lets the existing `jq` package handle parsing without adding a runtime dependency.
-
-Writes use a temporary file followed by an atomic rename. Command and scheduler mutations use a user-level file lock so a cancellation cannot race with a firing event or another creation.
-
-**Alternative considered:** SQLite. Rejected because this is a single-user local state file with no query volume or relational data; SQLite would add setup and migration overhead.
-
-### 2. Use one CLI executable with `timer` and `alarm` entry points
-
-Install a shared implementation and expose the requested commands. `timer DURATION`, `timer list`, and `timer cancel ID` manage timers. `alarm [DATE] TIME [DESCRIPTION...]`, `alarm list`, and `alarm cancel ID` manage alarms. Numeric IDs make cancellation unambiguous when unlimited events exist.
-
-Durations support a single positive numeric value with a unit such as `s`, `m`, or `h`. Time-only alarms resolve to the next occurrence in local time. Explicit dated alarms use the supplied date and are rejected when already in the past. Alarm creation rejects an existing alarm with the same normalized timestamp.
-
-**Alternative considered:** A single `alarm set` command. Rejected because it would not preserve the requested ergonomic `timer 10m` and `alarm 15:10` commands.
-
-### 3. Use a polling user service for scheduling
-
-The scheduler runs under `systemd --user`, checks state once per second, and removes events whose deadlines were missed while the service or computer was unavailable. It fires an event only when the scheduler observes the event at or after its deadline without having previously missed it. After firing, it removes the event before sending completion effects, preventing duplicate notifications if the effect command fails.
-
-**Alternative considered:** One systemd timer unit per event. Rejected because unlimited dynamic units complicate creation, cancellation, cleanup, and missed-event semantics. A single small scheduler is easier to reason about and sufficient for a personal desktop.
-
-### 4. Reuse the existing desktop notification and audio stack
-
-Completion uses `notify-send` with critical urgency so SwayNC applies its existing critical styling. It plays a one-second sound through `pw-play`, using a packaged freedesktop sound-theme file. Notification and sound failures do not restore or duplicate the already-completed event.
-
-**Alternative considered:** Terminal bell only. Rejected because terminal bells depend on the terminal and may be disabled or inaudible outside the originating shell.
-
-### 5. Make Waybar a read-only state consumer
-
-`alarm-waybar` reads active state, removes invalid/stale entries from its output without mutating the scheduler state, sorts timers and alarms by due timestamp, and emits JSON for the three closest entries. It emits an empty text value when there are no active events, allowing Waybar to hide the module. Timer text uses `HH:MM` above one minute and seconds below one minute; alarms use fixed local `HH:MM` time. Descriptions appear in escaped tooltips.
-
-The external Waybar config adds `custom/alarm` directly after `hyprland/workspaces` in `modules-left`, with `interval: 1`, JSON return type, and no click handlers. The external stylesheet adds the module to the existing shared module selector.
-
-### 6. Package the feature as a reusable Home Manager module
-
-The module owns the CLI, scheduler, Waybar helper, state directory setup, sound theme dependency, and user service. `hosts/jpporta-nixos/home.nix` imports and enables it. Other hosts remain unaffected until they explicitly enable the option.
-
-## Risks / Trade-offs
-
- **[One-second polling consumes a small amount of CPU]** → Keep the scheduler as a single process with a one-second sleep and use the same interval only for the Waybar helper; avoid one process per event.
- **[System time changes can move deadlines]** → Store absolute local timestamps and compare against the current wall clock on every loop; document that manual clock changes affect pending events.
- **[Concurrent state updates can lose events]** → Serialize mutations with a lock and write state atomically through a temporary file.
- **[A sound file may be unavailable on a different host]** → Package the freedesktop sound theme with the module and make audio playback best-effort while still sending the notification.
- **[Waybar lives in a separate repository]** → Keep the generated helper in ndots, make the external config edit explicit in the task list, and verify both repositories independently.
- **[Descriptions may contain shell-sensitive or JSON-sensitive characters]** → Treat descriptions as data, avoid shell interpolation of user text, and JSON-escape all Waybar and notification fields.
-
-## Migration Plan
-
-1. Enable the new Home Manager module on `jpporta-nixos` and rebuild the user environment.
-2. Add the `custom/alarm` module and CSS selector to `~/dotfiles/waybar/.config/waybar/`.
-3. Start or reload Waybar and the user scheduler through the normal Hyprland session.
-4. Verify creation, listing, cancellation, Waybar refresh, completion notification, sound, duplicate rejection, and missed-event cleanup.
-5. Roll back by disabling the module, removing the Waybar entry, and deleting the optional state directory if the user wants to discard pending events.
-
-## Open Questions
-
- None blocking implementation. Explicit dated alarms are defined to reject past timestamps; only time-only alarms roll forward to the next day.
@@ -1,32 +0,0 @@
-## Why
-
-The desktop currently has no quick, reliable way to schedule short-lived timers or wall-clock alarms from a terminal. A local command-line scheduler would make these events available from any shell while keeping their status visible in the existing Waybar and using the existing SwayNC/PipeWire desktop stack for completion alerts.
-
-## What Changes
-
- Add reusable Home Manager support for `timer` and `alarm` commands.
- Persist unlimited active timers and alarms with numeric IDs.
- Support timer durations, time-only alarms, dated alarms, optional descriptions, listing, cancellation, and duplicate alarm prevention.
- Add a user-level scheduler that fires due events once, skips events missed while the computer is unavailable, and survives the terminal closing.
- Send one critical desktop notification and play a one-second PipeWire sound when an event fires.
- Add a Waybar JSON module that refreshes every second and displays the three closest active events across both event types.
- Integrate the module into the external Waybar configuration at `~/dotfiles/waybar/.config/waybar/`, immediately after workspaces in `modules-left`.
- Exclude recurring alarms, snoozing, pause/resume, graphical management, and Waybar click actions.
-
-## Capabilities
-
-### New Capabilities
-
- `terminal-alarms-and-timers`: Create, persist, inspect, cancel, schedule, and complete terminal timers and wall-clock alarms, including their Waybar status display.
-
-### Modified Capabilities
-
-<!-- No existing capability requirements change. -->
-
-## Impact
-
- Adds a reusable Home Manager module under `modules/home-manager/` and enables it for `jpporta-nixos` only.
- Adds user-facing commands, persisted state under `~/.local/state`, and a systemd user service.
- Uses existing `jq`, `notify-send`/SwayNC, PipeWire, and Waybar conventions; adds the freedesktop sound theme if needed for the completion sound.
- Updates the separately managed Waybar config and stylesheet under `~/dotfiles/waybar/.config/waybar/`.
- No network services, database, external API, or system-wide daemon is introduced.
@@ -1,162 +0,0 @@
-## ADDED Requirements
-
-### Requirement: Create timers
-
-The system SHALL provide a `timer` command that accepts a positive duration and creates a new timer with a unique numeric ID and an absolute local wall-clock deadline.
-
-#### Scenario: Create a minute timer
-
- **WHEN** the user runs `timer 10m`
- **THEN** the system creates one timer due ten minutes after the command is accepted and prints its numeric ID
-
-#### Scenario: Reject an invalid duration
-
- **WHEN** the user runs `timer 0m`, `timer -1h`, or an unsupported duration format
- **THEN** the system rejects the command without creating an event
-
-### Requirement: Create alarms
-
-The system SHALL provide an `alarm` command that accepts a local time, an optional date, and an optional free-form description.
-
-#### Scenario: Create a future time-only alarm
-
- **WHEN** the user runs `alarm 15:10` before 15:10 local time
- **THEN** the system creates an alarm for 15:10 on the current local date
-
-#### Scenario: Roll a passed time-only alarm to tomorrow
-
- **WHEN** the user runs `alarm 15:10` at or after 15:10 local time
- **THEN** the system creates an alarm for 15:10 on the next local date
-
-#### Scenario: Create a dated alarm with a description
-
- **WHEN** the user runs `alarm 2026-08-01 10:20 Important Meeting`
- **THEN** the system creates an alarm for that local date and time with `Important Meeting` as its description
-
-#### Scenario: Reject a past explicit date
-
- **WHEN** the user supplies an explicit date and the resulting local timestamp is in the past
- **THEN** the system rejects the command without creating an event
-
-#### Scenario: Reject a duplicate alarm timestamp
-
- **WHEN** an alarm already exists at the requested normalized timestamp
- **THEN** the system rejects the new alarm without creating a second event
-
-### Requirement: List active events
-
-The system SHALL provide `timer list` and `alarm list` commands that display active events with their numeric IDs, type-appropriate due information, and optional descriptions.
-
-#### Scenario: List timers and alarms
-
- **WHEN** the user runs either list command
- **THEN** the system displays only active events of that type in deadline order with IDs suitable for cancellation
-
-#### Scenario: List with no events
-
- **WHEN** the selected event type has no active events
- **THEN** the system exits successfully and reports that no events are scheduled
-
-### Requirement: Cancel events by ID
-
-The system SHALL provide `timer cancel ID` and `alarm cancel ID` commands that remove the matching active event.
-
-#### Scenario: Cancel an existing event
-
- **WHEN** the user cancels an existing event ID with the matching command
- **THEN** the system removes that event and confirms the cancellation
-
-#### Scenario: Cancel an unknown or mismatched ID
-
- **WHEN** the requested ID does not exist for the selected command
- **THEN** the system reports an error and leaves all events unchanged
-
-### Requirement: Persist and serialize event state
-
-The system SHALL persist active events under the user's XDG state directory and SHALL serialize state mutations so concurrent creation, cancellation, scheduling, and firing cannot overwrite each other's changes.
-
-#### Scenario: Terminal exits after creation
-
- **WHEN** the shell that created an event exits
- **THEN** the event remains available to the scheduler and list commands
-
-#### Scenario: Concurrent state mutation
-
- **WHEN** a command and the scheduler update state at the same time
- **THEN** one complete update is applied without corrupting or losing unrelated events
-
-### Requirement: Schedule due events
-
-The system SHALL run a user-level scheduler that checks active events against the local wall clock and completes each observed due event once.
-
-#### Scenario: Timer reaches its deadline
-
- **WHEN** the scheduler observes an active timer at or after its deadline before it has been missed
- **THEN** the system removes the timer and emits its completion effects exactly once
-
-#### Scenario: Event is missed while unavailable
-
- **WHEN** an event deadline passes while the computer or scheduler is unavailable
- **THEN** the system removes the event without emitting a notification or sound
-
-#### Scenario: Completion effect fails
-
- **WHEN** notification or sound playback fails after an event is marked complete
- **THEN** the event remains removed and is not retried as a duplicate event
-
-### Requirement: Notify and play sound on completion
-
-The system SHALL send one critical desktop notification and SHALL attempt to play a one-second PipeWire sound when an observed timer or alarm completes.
-
-#### Scenario: Complete an event with a description
-
- **WHEN** an event with a description completes
- **THEN** the critical notification identifies the event type and includes the description, and the system attempts one sound playback
-
-#### Scenario: Complete an event without a description
-
- **WHEN** an event without a description completes
- **THEN** the critical notification identifies the event type and deadline without an empty description artifact, and the system attempts one sound playback
-
-### Requirement: Display the nearest events in Waybar
-
-The system SHALL provide a JSON-producing Waybar helper that refreshes every second and represents at most the three closest active events across timers and alarms.
-
-#### Scenario: Display mixed event types
-
- **WHEN** active timers and alarms exist
- **THEN** the helper sorts all events by deadline and emits only the three closest with distinct timer and alarm icons
-
-#### Scenario: Format a timer above one minute
-
- **WHEN** a displayed timer has at least one minute remaining
- **THEN** its text uses `HH:MM` remaining time
-
-#### Scenario: Format a timer below one minute
-
- **WHEN** a displayed timer has less than one minute remaining
- **THEN** its text contains only the remaining seconds
-
-#### Scenario: Format an alarm
-
- **WHEN** a displayed alarm is active
- **THEN** its text contains its fixed local due time in `HH:MM` format
-
-#### Scenario: Hide the empty module
-
- **WHEN** no active events exist
- **THEN** the helper emits an empty Waybar text value
-
-#### Scenario: Show descriptions safely
-
- **WHEN** a displayed event has a description containing spaces or JSON-sensitive characters
- **THEN** the helper emits valid JSON and exposes the description through the tooltip without shell or JSON injection
-
-### Requirement: Integrate the Waybar module
-
-The Waybar configuration SHALL place the event module immediately after workspaces in `modules-left`, refresh it every second, use JSON return type, and define no click actions.
-
-#### Scenario: Load the module in the left bar
-
- **WHEN** Waybar starts with the updated external configuration
- **THEN** the event module appears after the workspace module and disappears when its text is empty
@@ -1,45 +0,0 @@
-## 1. Module and State Foundation
-
- [x] 1.1 Create a reusable Home Manager module with a disabled-by-default `custom.alarms-timers.enable` option.
- [x] 1.2 Define the XDG state path, JSON event schema, numeric ID allocation, atomic writes, and file-locking helpers.
- [x] 1.3 Add strict parsing and normalization for timer durations, local times, explicit dates, and optional descriptions.
- [x] 1.4 Add `timer` and `alarm` command entry points for creation, validation errors, and ID output.
-
-## 2. Listing and Cancellation
-
- [x] 2.1 Implement `timer list` and `alarm list` with deadline ordering, IDs, descriptions, and empty-state output.
- [x] 2.2 Implement `timer cancel ID` and `alarm cancel ID` with type checking and unknown-ID errors.
- [x] 2.3 Add focused shell-level checks for creation, time-only rollover, explicit-date rejection, duplicate alarms, listing, cancellation, and malformed input.
-
-## 3. Scheduler and Completion Effects
-
- [x] 3.1 Implement the user scheduler loop with one-second wall-clock checks and serialized state access.
- [x] 3.2 Remove events missed while the scheduler or computer was unavailable without notifying.
- [x] 3.3 Remove an observed due event before running completion effects so failures cannot duplicate notifications.
- [x] 3.4 Send one critical `notify-send` notification with type, deadline, and optional description.
- [x] 3.5 Package or reference a freedesktop sound-theme file and play it once for approximately one second through `pw-play`.
- [x] 3.6 Define and enable the systemd user service on the graphical session, with restart behavior that does not replay missed events.
- [x] 3.7 Add scheduler checks for due events, missed events, duplicate prevention, notification failure, and concurrent state mutation.
-
-## 4. Home Manager Integration
-
- [x] 4.1 Install the CLI, scheduler, Waybar helper, `jq`, PipeWire playback dependency, and sound theme through the reusable module.
- [x] 4.2 Enable the module in `hosts/jpporta-nixos/home.nix` without enabling it for other hosts.
- [x] 4.3 Add state-directory initialization and verify the generated user service and executable paths.
- [x] 4.4 Evaluate and build the `jpporta-nixos` configuration to catch Nix/module errors.
-
-## 5. Waybar Integration
-
- [x] 5.1 Implement `alarm-waybar` JSON output with global deadline ordering and a maximum of three entries.
- [x] 5.2 Format timers as `HH:MM` above one minute and seconds below one minute; format alarms as fixed local `HH:MM` times.
- [x] 5.3 Add safely escaped descriptions to Waybar tooltips and emit empty text when no events exist.
- [x] 5.4 Update `~/dotfiles/waybar/.config/waybar/config.jsonc` with `custom/alarm` immediately after workspaces, one-second refresh, JSON return type, and no click actions.
- [x] 5.5 Update the Waybar stylesheet selector for the new module and verify it matches the existing visual treatment.
- [x] 5.6 Reload Waybar and manually verify mixed timer/alarm ordering, three-item truncation, countdown updates, tooltip content, and hidden empty state.
-
-## 6. End-to-End Verification
-
- [x] 6.1 Create representative timers and alarms from a terminal and verify IDs, list output, duplicate rejection, and cancellation.
- [x] 6.2 Verify a due event produces exactly one critical SwayNC notification and one short PipeWire sound.
- [x] 6.3 Verify scheduler restart or system resume removes missed events without producing late notifications.
- [x] 6.4 Verify the final Nix build and Waybar configuration together on `jpporta-nixos`.
@@ -1,55 +0,0 @@
-# GIF Recorder
-
-## Purpose
-
-This capability provides an opt-in Wayland workflow for recording a selected screen region as a GIF, saving it as a screenshot, and copying it to the clipboard.
-
-## Requirements
-
-### Requirement: Region recording is toggled by one command
-The GIF recorder SHALL use one executable that starts an interactive region recording when idle and stops the active recording when invoked again.
-
-#### Scenario: Start a recording
- **WHEN** the recorder is invoked while no recording is active
- **THEN** it lets the user select a rectangular Wayland region and starts recording that region
-
-#### Scenario: Stop a recording
- **WHEN** the recorder is invoked while a recording is active
- **THEN** it stops the active recording and begins finalization without starting a second recording
-
-#### Scenario: Cancel region selection
- **WHEN** the user cancels region selection before recording starts
- **THEN** the recorder exits without creating a GIF and clears its runtime state
-
-### Requirement: Completed recordings are saved as GIF screenshots
-The recorder SHALL save each successfully finalized recording as a timestamped `.gif` file below `~/Pictures/Screenshots`.
-
-#### Scenario: Successful finalization
- **WHEN** an active recording is stopped and encoding succeeds
- **THEN** the recorder creates the screenshots directory if needed and stores one completed GIF there
-
-#### Scenario: Failed finalization
- **WHEN** recording or GIF encoding fails
- **THEN** the recorder does not publish a partial GIF as a completed screenshot and removes temporary recording data
-
-### Requirement: Completed recordings are copied to the Wayland clipboard
-After successful GIF encoding, the recorder SHALL copy the resulting file to the Wayland clipboard using the `image/gif` MIME type.
-
-#### Scenario: Clipboard copy succeeds
- **WHEN** a GIF is successfully written
- **THEN** the recorder publishes that GIF to the clipboard as `image/gif`
-
-#### Scenario: Clipboard copy is unavailable
- **WHEN** a GIF is successfully written but clipboard publication fails
- **THEN** the recorder preserves the GIF in `~/Pictures/Screenshots` and exits without deleting it
-
-### Requirement: Home Manager integration is opt-in
-The feature SHALL be exposed as a Home Manager module with an enable option, and enabling it SHALL install all required runtime tools and the recorder executable.
-
-#### Scenario: Module enabled
- **WHEN** `custom.gif-recorder.enable` is true
- **THEN** the user environment contains the recorder command and its Wayland recording, selection, encoding, and clipboard dependencies
-
-#### Scenario: Module disabled
- **WHEN** `custom.gif-recorder.enable` is false
- **THEN** the module adds no GIF recorder command, packages, or Hyprland bind
@@ -1,166 +0,0 @@
-## Purpose
-
-Provide terminal timers and wall-clock alarms that persist independently of the creating shell, notify on completion, and expose the nearest active events in Waybar.
-
-## Requirements
-
-### Requirement: Create timers
-
-The system SHALL provide a `timer` command that accepts a positive duration and creates a new timer with a unique numeric ID and an absolute local wall-clock deadline.
-
-#### Scenario: Create a minute timer
-
- **WHEN** the user runs `timer 10m`
- **THEN** the system creates one timer due ten minutes after the command is accepted and prints its numeric ID
-
-#### Scenario: Reject an invalid duration
-
- **WHEN** the user runs `timer 0m`, `timer -1h`, or an unsupported duration format
- **THEN** the system rejects the command without creating an event
-
-### Requirement: Create alarms
-
-The system SHALL provide an `alarm` command that accepts a local time, an optional date, and an optional free-form description.
-
-#### Scenario: Create a future time-only alarm
-
- **WHEN** the user runs `alarm 15:10` before 15:10 local time
- **THEN** the system creates an alarm for 15:10 on the current local date
-
-#### Scenario: Roll a passed time-only alarm to tomorrow
-
- **WHEN** the user runs `alarm 15:10` at or after 15:10 local time
- **THEN** the system creates an alarm for 15:10 on the next local date
-
-#### Scenario: Create a dated alarm with a description
-
- **WHEN** the user runs `alarm 2026-08-01 10:20 Important Meeting`
- **THEN** the system creates an alarm for that local date and time with `Important Meeting` as its description
-
-#### Scenario: Reject a past explicit date
-
- **WHEN** the user supplies an explicit date and the resulting local timestamp is in the past
- **THEN** the system rejects the command without creating an event
-
-#### Scenario: Reject a duplicate alarm timestamp
-
- **WHEN** an alarm already exists at the requested normalized timestamp
- **THEN** the system rejects the new alarm without creating a second event
-
-### Requirement: List active events
-
-The system SHALL provide `timer list` and `alarm list` commands that display active events with their numeric IDs, type-appropriate due information, and optional descriptions.
-
-#### Scenario: List timers and alarms
-
- **WHEN** the user runs either list command
- **THEN** the system displays only active events of that type in deadline order with IDs suitable for cancellation
-
-#### Scenario: List with no events
-
- **WHEN** the selected event type has no active events
- **THEN** the system exits successfully and reports that no events are scheduled
-
-### Requirement: Cancel events by ID
-
-The system SHALL provide `timer cancel ID` and `alarm cancel ID` commands that remove the matching active event.
-
-#### Scenario: Cancel an existing event
-
- **WHEN** the user cancels an existing event ID with the matching command
- **THEN** the system removes that event and confirms the cancellation
-
-#### Scenario: Cancel an unknown or mismatched ID
-
- **WHEN** the requested ID does not exist for the selected command
- **THEN** the system reports an error and leaves all events unchanged
-
-### Requirement: Persist and serialize event state
-
-The system SHALL persist active events under the user's XDG state directory and SHALL serialize state mutations so concurrent creation, cancellation, scheduling, and firing cannot overwrite each other's changes.
-
-#### Scenario: Terminal exits after creation
-
- **WHEN** the shell that created an event exits
- **THEN** the event remains available to the scheduler and list commands
-
-#### Scenario: Concurrent state mutation
-
- **WHEN** a command and the scheduler update state at the same time
- **THEN** one complete update is applied without corrupting or losing unrelated events
-
-### Requirement: Schedule due events
-
-The system SHALL run a user-level scheduler that checks active events against the local wall clock and completes each observed due event once.
-
-#### Scenario: Timer reaches its deadline
-
- **WHEN** the scheduler observes an active timer at or after its deadline before it has been missed
- **THEN** the system removes the timer and emits its completion effects exactly once
-
-#### Scenario: Event is missed while unavailable
-
- **WHEN** an event deadline passes while the computer or scheduler is unavailable
- **THEN** the system removes the event without emitting a notification or sound
-
-#### Scenario: Completion effect fails
-
- **WHEN** notification or sound playback fails after an event is marked complete
- **THEN** the event remains removed and is not retried as a duplicate event
-
-### Requirement: Notify and play sound on completion
-
-The system SHALL send one critical desktop notification and SHALL attempt to play a one-second PipeWire sound when an observed timer or alarm completes.
-
-#### Scenario: Complete an event with a description
-
- **WHEN** an event with a description completes
- **THEN** the critical notification identifies the event type and includes the description, and the system attempts one sound playback
-
-#### Scenario: Complete an event without a description
-
- **WHEN** an event without a description completes
- **THEN** the critical notification identifies the event type and deadline without an empty description artifact, and the system attempts one sound playback
-
-### Requirement: Display the nearest events in Waybar
-
-The system SHALL provide a JSON-producing Waybar helper that refreshes every second and represents at most the three closest active events across timers and alarms.
-
-#### Scenario: Display mixed event types
-
- **WHEN** active timers and alarms exist
- **THEN** the helper sorts all events by deadline and emits only the three closest with distinct timer and alarm icons
-
-#### Scenario: Format a timer above one minute
-
- **WHEN** a displayed timer has at least one minute remaining
- **THEN** its text uses `HH:MM` remaining time
-
-#### Scenario: Format a timer below one minute
-
- **WHEN** a displayed timer has less than one minute remaining
- **THEN** its text contains only the remaining seconds
-
-#### Scenario: Format an alarm
-
- **WHEN** a displayed alarm is active
- **THEN** its text contains its fixed local due time in `HH:MM` format
-
-#### Scenario: Hide the empty module
-
- **WHEN** no active events exist
- **THEN** the helper emits an empty Waybar text value
-
-#### Scenario: Show descriptions safely
-
- **WHEN** a displayed event has a description containing spaces or JSON-sensitive characters
- **THEN** the helper emits valid JSON and exposes the description through the tooltip without shell or JSON injection
-
-### Requirement: Integrate the Waybar module
-
-The Waybar configuration SHALL place the event module immediately after workspaces in `modules-left`, refresh it every second, use JSON return type, and define no click actions.
-
-#### Scenario: Load the module in the left bar
-
- **WHEN** Waybar starts with the updated external configuration
- **THEN** the event module appears after the workspace module and disappears when its text is empty
@@ -1,41 +0,0 @@
-#!/usr/bin/env bash
-set -euo pipefail
-
-tmp=$(mktemp -d)
-trap 'rm -rf "$tmp"' EXIT
-export XDG_STATE_HOME="$tmp/state"
-runtime=${1:?pass path to alarm-runtime}
-
-test "$("$runtime" timer 2s)" = 1
-test "$("$runtime" alarm "$(date +%H:%M)" Rolled Over)" = 2
-test "$("$runtime" alarm "$(date -d tomorrow +%F)" 10:20 Important Meeting)" = 3
-! "$runtime" timer 0m >/dev/null 2>&1
-! "$runtime" alarm "$(date -d yesterday +%F)" 10:20 >/dev/null 2>&1
-! "$runtime" alarm "$(date -d tomorrow +%F)" 10:20 >/dev/null 2>&1
-test "$("$runtime" timer list | wc -l)" = 1
-"$runtime" timer cancel 1 >/dev/null
-! "$runtime" timer cancel 1 >/dev/null 2>&1
-test "$("$runtime" timer list)" = "No timer events scheduled."
-
-mkdir -p "$tmp/bin"
-printf '#!/bin/sh\nprintf notify >> "$LOG"\n' > "$tmp/bin/notify-send"
-printf '#!/bin/sh\nprintf sound >> "$LOG"\n' > "$tmp/bin/pw-play"
-chmod +x "$tmp/bin/notify-send" "$tmp/bin/pw-play"
-export PATH="$tmp/bin:$PATH" LOG="$tmp/effects"
-test "$("$runtime" timer 1s)" = 4
-sleep 2
-set +e
-timeout 2 "$runtime" scheduler
-status=$?
-set -e
-test "$status" = 124
-test ! -s "$LOG"
-test "$("$runtime" timer 1s)" = 5
-set +e
-timeout 3 "$runtime" scheduler
-status=$?
-set -e
-test "$status" = 124
-test "$(wc -c < "$LOG")" = 11
-test "$(jq '.events | length' "$XDG_STATE_HOME/alarm/events.json")" = 2
-printf 'alarm/timer checks passed\n'
@@ -28,12 +28,10 @@ cmd_init() {
    git rev-parse --show-toplevel >/dev/null 2>&1 || _die "not a git repo"

    mkdir -p "$WORKTREE_ROOT"
-    if [ -d openspec ]; then
-        _ok "openspec already initialized"
-    else
+    [ -d openspec ] && _ok "openspec already initialized" || {
        openspec init --tools opencode --force
        _ok "openspec initialized"
-    fi
+    }

    grep -qxF '.worktrees/' .gitignore 2>/dev/null || {
        echo '.worktrees/' >> .gitignore
@@ -184,6 +182,7 @@ cmd_build() {
            openspec archive "$name" --yes 2>/dev/null || true

            echo "── Merging to main ──"
+            local current_branch=$(git branch --show-current)
            git merge "$branch" -m "dev-flow: merge $name" 2>/dev/null || {
                echo "⚠ Merge conflict. Resolve manually in $wt then run:"
                echo "   cd $wt && git checkout main && git merge $branch"
@@ -221,8 +220,7 @@ cmd_status() {
    local n=0
    for wt in "$WORKTREE_ROOT"/*/; do
        [ -d "$wt" ] || continue
-        local name
-        name=$(basename "$wt")
+        local name=$(basename "$wt")
        local branch; branch="$(_wt_branch "$name")"
        local commits="?"
        [ -d "$wt/.git" ] && commits=$(cd "$wt" && git rev-list --count "$branch" -- 2>/dev/null || echo "?")
@@ -303,4 +301,4 @@ case "${1:-}" in
        echo "branches named:    dev-flow/<feature>"
        exit 1
        ;;
-esac
+esac
Author	SHA1	Message	Date
hermes-bot	810047a074	fix: shellcheck warnings for Nix writeShellApplication - Remove unused SCRIPT_DIR (SC2034) - Split local var= declaration from assignment (SC2155) - Replace &&/\|\| with if/else in cmd_clean (SC2015) - Add shellcheck disable for .venv source (SC1091)	2026-08-05 10:46:52 -03:00
hermes-bot	32bc53bb68	dev-orchestrator: decouple spec scaffold from fill, delegate exploration to OpenSpec native /opsx commands - cmd_spec now only scaffolds (OpenSpec change + worktree + deps), no auto-fill - Added cmd_fill as fallback for headless spec filling - Output guides user to /opsx:explore and /opsx:continue inside OpenCode - cmd_build (dev→QA loop) unchanged — core value proposition	2026-08-05 10:43:35 -03:00
hermes	80556753e3	feat(dev-orchestrator): add NixOS home-manager module - New module: modules/home-manager/dev-orchestrator/ - Wraps script via writeShellApplication, git as runtime dep - opencode + openspec already in PATH via existing modules - Enabled in jpporta-nixos home.nix After rebuild: dev-orchestrator available in PATH	2026-08-04 18:41:40 -03:00
hermes	c53a7f278b	docs: expand WORKFLOW.md with tool interaction guide - Added per-tool usage: when to use OpenCode/OpenSpec directly vs orchestrator - Direct interaction patterns for manual work - Clear gate: you review specs before build — critical step - When to step out of the orchestrator workflow - Smoother flow diagram	2026-08-04 18:26:08 -03:00
hermes	6d861958ce	feat(tooling): add dev-orchestrator script + workflow guide - dev-orchestrator: OpenSpec + OpenCode dev→QA loop with git worktrees - WORKFLOW.md: complete usage guide and architecture documentation Commands: init, spec, build, status, clean Zero heavy dependencies — only git, opencode, openspec	2026-08-04 18:24:29 -03:00