@raquezha/norpiv 0.0.2

package/implement/scripts/enforce-branch.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+
+# enforce-branch.sh
+# Verifies the active branch before implementation.
+# Prevents working on main/master and ensures alignment with task metadata.
+
+set -euo pipefail
+
+json_read() {
+    local file="$1"
+    local expr="$2"
+    python3 - "$file" "$expr" <<'PY'
+import json
+import re
+import sys
+from pathlib import Path
+
+path = Path(sys.argv[1])
+expr = sys.argv[2]
+try:
+    data = json.loads(path.read_text())
+except Exception:
+    print("")
+    raise SystemExit
+
+for part in [p.strip() for p in expr.split("//")]:
+    if part == "empty":
+        continue
+    match = re.fullmatch(r"\.([A-Za-z_][A-Za-z0-9_]*)", part)
+    if not match or not isinstance(data, dict):
+        continue
+    value = data.get(match.group(1))
+    if value not in (None, ""):
+        print(value)
+        raise SystemExit
+print("")
+PY
+}
+
+json_pretty() {
+    local file="$1"
+    python3 -m json.tool "$file"
+}
+
+# Find repo root to ensure paths are absolute and reliable
+REPO_ROOT=$(git rev-parse --show-toplevel)
+ACTIVE_TASK_FILE="$REPO_ROOT/.workflow/active_task.json"
+
+if [[ ! -f "$ACTIVE_TASK_FILE" ]]; then
+    echo "ERROR: No active task found at $ACTIVE_TASK_FILE."
+    echo "Please run /triage [source]:[id] first."
+    exit 1
+fi
+
+# Read canonical active task fields
+TASK_SOURCE=$(json_read "$ACTIVE_TASK_FILE" '.source // empty')
+TASK_ID=$(json_read "$ACTIVE_TASK_FILE" '.sourceId // .id // empty')
+TASK_PATH=$(json_read "$ACTIVE_TASK_FILE" '.taskPath // .path // empty')
+
+# Prefer explicit taskPath when available (most reliable)
+if [[ -n "$TASK_PATH" ]]; then
+    echo "INFO: Using taskPath from active_task.json: $TASK_PATH"
+    if [[ "$TASK_PATH" = /* ]]; then
+        WORK_MD="$TASK_PATH/WORK.md"
+    else
+        WORK_MD="$REPO_ROOT/$TASK_PATH/WORK.md"
+    fi
+
+# If no taskPath, but we have a source+id, construct the folder name as '<source>-<id>'
+elif [[ -n "$TASK_ID" ]]; then
+    echo "INFO: taskPath missing; deriving task folder from source+id"
+    if [[ -n "$TASK_SOURCE" ]]; then
+        TASK_FOLDER="${TASK_SOURCE}-${TASK_ID}"
+    else
+        TASK_FOLDER="$TASK_ID"
+    fi
+    WORK_MD="$REPO_ROOT/.workflow/tasks/$TASK_FOLDER/WORK.md"
+
+else
+    echo "ERROR: No 'sourceId' or 'taskPath' found in $ACTIVE_TASK_FILE."
+    echo "Please run /triage [source]:[id] to initialize a task. Here are the file contents for debugging:" 
+    json_pretty "$ACTIVE_TASK_FILE" || true
+    exit 1
+fi
+
+# Diagnostic output for easier debugging when things go wrong
+echo "DEBUG: Computed WORK.md path: $WORK_MD"
+
+if [[ ! -f "$WORK_MD" ]]; then
+    echo "ERROR: WORK.md not found at $WORK_MD."
+    echo "Checked active_task.json values:" 
+    json_pretty "$ACTIVE_TASK_FILE" || true
+    echo "Please ensure the task was initialized with /triage and that WORK.md exists." 
+    exit 1
+fi
+
+CURRENT_BRANCH=$(git branch --show-current)
+echo "Current branch: $CURRENT_BRANCH"
+
+# Check if we are on a protected branch
+if [[ "$CURRENT_BRANCH" == "main" || "$CURRENT_BRANCH" == "master" ]]; then
+    echo "WARNING: Currently on protected branch '$CURRENT_BRANCH'."
+    
+    # Generate a safe task branch name
+    # Prefer using the active_task folder name if available, else sanitize TASK_ID
+    if [[ -n "${TASK_FOLDER:-}" ]]; then
+        CLEAN_ID=$(echo "$TASK_FOLDER" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/-\+/-/g' | sed 's/^-//;s/-$//')
+    else
+        CLEAN_ID=$(echo "$TASK_ID" | tr '[:upper:]' '[:lower:]' | sed 's/[^a-z0-9]/-/g' | sed 's/-\+/-/g' | sed 's/^-//;s/-$//')
+    fi
+    NEW_BRANCH="feat/${CLEAN_ID}"
+    
+    echo "ACTION: Creating and switching to task branch: $NEW_BRANCH"
+    git checkout -b "$NEW_BRANCH"
+    echo "SUCCESS: Branch switched to $NEW_BRANCH."
+    echo "AGENT_INSTRUCTION: Update [META] in WORK.md to record 'Branch: $NEW_BRANCH'."
+    exit 0
+fi
+
+echo "Branch is not protected. Safe to proceed."
+echo "AGENT_INSTRUCTION: Ensure $CURRENT_BRANCH is recorded in [META] of WORK.md."
+exit 0

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@raquezha/norpiv",
+  "version": "0.0.2",
+  "description": "Bundled RPIV workflow skills for Pi, Claude, and Codex-style coding agents",
+  "type": "commonjs",
+  "bin": {
+    "norpiv-install": "bin/norpiv-install.cjs"
+  },
+  "files": [
+    "bin",
+    "cleanup",
+    "frame",
+    "grill-with-docs",
+    "implement",
+    "plan",
+    "scripts",
+    "sync",
+    "triage",
+    "update-docs",
+    "verify",
+    "README.md"
+  ],
+  "keywords": [
+    "agent-skills",
+    "pi-agent",
+    "claude-skills",
+    "codex",
+    "workflow",
+    "rpiv",
+    "pi-package"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "skills": [
+      "triage",
+      "frame",
+      "grill-with-docs",
+      "plan",
+      "implement",
+      "verify",
+      "sync",
+      "update-docs",
+      "cleanup"
+    ]
+  }
+}

package/plan/SKILL.md

@@ -0,0 +1,34 @@
+---
+name: plan
+description: Create or revise vertical implementation slices in the active WORK.md. Use after /grill-with-docs to produce a concise, reviewable plan for implementation.
+---
+
+# Skill: plan
+
+Map the "how" into tracer-bullet vertical slices.
+
+## Guardrails
+- READ: `.workflow/active_task.json` then active `WORK.md` `[BRIEF]` and `[GRILL]`.
+- WRITE: `WORK.md` -> `[PLAN]` and append to `[LOG]` only.
+- NEVER: implement code during planning.
+- NEVER: create standalone `PLAN.md`.
+- NEVER: ask whether to plan if the user invoked `/plan`; produce the plan.
+
+## Workflow
+1. Read the brief and grill decisions.
+2. **Branch Check**: Verify the current git branch. Planning on `main` is safe and encouraged. If you are on an unrelated feature branch, warn the human that the plan is being made on a stale or mismatched context.
+3. Draft thin vertical slices that are independently verifiable.
+4. Mark each slice:
+   - **AFK**: agent can implement with clear checks.
+   - **HITL**: human judgment, product decision, external access, or manual review required.
+5. Include dependencies and verification command(s) per slice.
+6. Write the plan into `[PLAN]` with checkboxes.
+7. **Log Activity**: Append a timestamped entry to `[LOG]` summarizing the plan or revision (Format: `YYYY-MM-DD hh:mm AM/PM`).
+8. Recommend `/sync` if the task has a tracker, then `/implement`.
+
+## Output contract
+End with:
+- **Slices**: count and names
+- **AFK/HITL split**
+- **Verification commands**
+- **Next step**: `/sync` or `/implement`

package/scripts/reposcry-bootstrap.sh

@@ -0,0 +1,84 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
+cd "$REPO_ROOT"
+
+ensure_reposcry_gitignore() {
+  local gitignore=".gitignore"
+  touch "$gitignore"
+
+  if ! grep -qxF ".reposcry/" "$gitignore"; then
+    {
+      printf '\n# RepoScry local cache\n'
+      printf '.reposcry/\n'
+    } >> "$gitignore"
+    echo "Added .reposcry/ to .gitignore"
+  fi
+}
+
+refuse_tracked_reposcry_cache() {
+  local tracked staged
+  tracked=$(git ls-files .reposcry 2>/dev/null || true)
+  staged=$(git diff --cached --name-only -- .reposcry 2>/dev/null || true)
+
+  if [[ -n "$tracked" || -n "$staged" ]]; then
+    echo "ERROR: .reposcry/ cache is tracked or staged. It is generated local state and must not be committed." >&2
+    if [[ -n "$tracked" ]]; then
+      echo "Tracked files:" >&2
+      printf '%s\n' "$tracked" >&2
+    fi
+    if [[ -n "$staged" ]]; then
+      echo "Staged files:" >&2
+      printf '%s\n' "$staged" >&2
+    fi
+    echo "Fix: git rm --cached -r .reposcry && keep .reposcry/ in .gitignore" >&2
+    exit 1
+  fi
+}
+
+reposcry_indexed_files() {
+  reposcry stats 2>/dev/null | awk '/Files indexed:/ {print $3; exit}'
+}
+
+ensure_reposcry_gitignore
+refuse_tracked_reposcry_cache
+
+if ! command -v reposcry >/dev/null 2>&1; then
+  echo "RepoScry not installed; skipping bootstrap."
+  exit 0
+fi
+
+HAD_REPOSCRYIGNORE=0
+[[ -f .reposcryignore ]] && HAD_REPOSCRYIGNORE=1
+
+FORCE_REINDEX=0
+if [[ "${1:-}" == "--force" || "${1:-}" == "--reindex" ]]; then
+  FORCE_REINDEX=1
+fi
+
+if [[ ! -d .reposcry ]]; then
+  echo "Initializing RepoScry..."
+  reposcry init >/dev/null 2>&1 || reposcry init || {
+    echo "RepoScry init failed; continuing without RepoScry." >&2
+    exit 0
+  }
+fi
+
+INDEXED_FILES=$(reposcry_indexed_files || true)
+INDEXED_FILES=${INDEXED_FILES:-0}
+
+if [[ $FORCE_REINDEX -eq 1 || "$INDEXED_FILES" == "0" ]]; then
+  echo "Indexing repository with RepoScry (--no-semantic)..."
+  reposcry index --no-semantic || {
+    echo "RepoScry index failed; continuing without RepoScry." >&2
+    exit 0
+  }
+else
+  echo "RepoScry index already present ($INDEXED_FILES files indexed)."
+fi
+
+if [[ $HAD_REPOSCRYIGNORE -eq 0 && -f .reposcryignore ]]; then
+  echo "RepoScry created .reposcryignore. Review and commit it if you want stable RepoScry indexing rules."
+fi

package/scripts/reposcry-refresh.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+BASE_REF=${1:-${REPOSCRY_BASE_REF:-main}}
+
+if ! command -v reposcry-update >/dev/null 2>&1; then
+  echo "reposcry-update not installed; skipping refresh."
+  exit 0
+fi
+
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
+cd "$REPO_ROOT"
+
+echo "Refreshing RepoScry for changed files against base '$BASE_REF'..."
+if ! reposcry-update --changed --base "$BASE_REF"; then
+  echo "RepoScry refresh failed; continuing without refreshed graph state." >&2
+  exit 0
+fi

package/scripts/reposcry-task-context.sh

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+TASK_TEXT=${*:-}
+if [[ -z "$TASK_TEXT" ]]; then
+  echo "Usage: $0 <task summary>"
+  exit 1
+fi
+
+if ! command -v reposcry >/dev/null 2>&1; then
+  echo "RepoScry not installed; skipping task context generation."
+  exit 0
+fi
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
+cd "$REPO_ROOT"
+
+"$SCRIPT_DIR/reposcry-bootstrap.sh" || true
+
+mkdir -p .reposcry
+BUDGET=${REPOSCRY_CONTEXT_BUDGET:-20000}
+OUTPUT_PATH=".reposcry/AI_CONTEXT.md"
+
+echo "Generating RepoScry task context at $OUTPUT_PATH..."
+if reposcry context "$TASK_TEXT" --strict --budget "$BUDGET" --format markdown > "$OUTPUT_PATH"; then
+  echo "Wrote $OUTPUT_PATH"
+else
+  echo "RepoScry context generation failed; leaving RPIV flow unchanged." >&2
+  rm -f "$OUTPUT_PATH"
+fi