@jenga-ai/agent 3.5.0 → 4.0.0

package/scripts/delete-bare-skill-dirs.sh

@@ -0,0 +1,329 @@
+#!/usr/bin/env bash
+# scripts/delete-bare-skill-dirs.sh — delete the bare-name skill directories and
+# rewrite their surviving j-<name> twins' frontmatter (E50_S15).
+#
+# Purpose
+# -------
+# Performs E50_S15's own irreversible step: for every skills/<name>/ that still has
+# its original, pre-`j-` "bare" directory form alongside its canonical
+# skills/j-<name>/ twin, (1) delete the bare directory outright and (2) rewrite the
+# twin's SKILL.md frontmatter `name:` field from the transitional `j.j-<name>` form
+# to the settled `j.<name>` form (E50_S10's contract). Both steps land together for
+# every entry in one script run: renaming the twin first (while the bare directory
+# still exists) would leave two directories both claiming `j.<name>`; deleting the
+# bare directory first would leave no directory claiming it until the rename
+# catches up. Neither intermediate state is ever produced by --apply, because this
+# script performs every rewrite before it performs any delete (see step 4 below),
+# and only after that first pass completes clean does it touch a filesystem entry.
+#
+# This script does NOT invoke `git commit`. E50_S15_T04 (the sole task allowed to
+# run --apply) is responsible for staging and committing the resulting working-tree
+# state as a single atomic commit immediately afterward — mirroring
+# scripts/repoint-skill-refs.sh and scripts/apply-j-prefix.sh, neither of which
+# commits on the caller's behalf either. Keeping VCS operations at the call site
+# (not buried inside this script) keeps the script's own contract to "leave the
+# working tree in the correct final state or abort with zero writes" — it does not
+# also have to reason about repo-wide staging concerns (what else might already be
+# staged, whether a lock file needs to be excluded, etc).
+#
+# Modes
+# -----
+#   --dry-run   Report the full computed delete set and, for each entry, the exact
+#               frontmatter line change planned. Nothing is written.
+#   --apply     Perform the deletion + rename in place. Requires the live count to
+#               still match EXPECTED_DELETE_COUNT (see below) or the run aborts
+#               with zero filesystem writes.
+#
+# Exactly one of --dry-run/--apply is required. Either mode always runs the delta
+# check and the count cross-check FIRST (see below) before touching or reporting on
+# any file.
+#
+# Usage
+# -----
+#   scripts/delete-bare-skill-dirs.sh --dry-run
+#   scripts/delete-bare-skill-dirs.sh --apply
+#
+# Delete-set computation — never hardcoded
+# ------------------------------------------
+# Computed fresh from disk on every invocation: every directory directly under
+# skills/ that (a) is not itself "j-"-prefixed, (b) is not one of the three
+# permanent exceptions (jenga, jenga-permission-level, index — E50_S06/E50), and
+# (c) has a matching skills/j-<name>/ twin on disk. E50_S15_T01 already showed the
+# live tree can drift from the story's authoring-time snapshot (6 orphan
+# j-<name>-only directories were added after the story was written) — a hardcoded
+# name list would silently miss a future drift the exact same way, so the set is
+# always recomputed, never literal.
+#
+# Count cross-check
+# ------------------
+# EXPECTED_DELETE_COUNT below is the one hardcoded number in this script — not a
+# name list, a single integer recorded by E50_S15_T01's live pre-flight recompute
+# (2026-09-19: 40). If the live computed delete-set size does not equal this
+# number, the script aborts with a non-zero exit and performs zero filesystem
+# writes, in either mode. This catches the case where skills/ drifted again
+# between T01's recompute and this script actually running --apply.
+#
+# Bare-vs-twin delta check
+# --------------------------
+# Before computing the delete set, every bare (non-"j-"-prefixed, non-exception)
+# directory under skills/ MUST have a skills/j-<name>/ twin on disk. Any unpaired
+# bare directory aborts the run (naming it) before any write — mirrors
+# scripts/repoint-skill-refs.sh's identical guard.
+#
+# Frontmatter rewrite
+# ---------------------
+# For every delete-set entry <name>, skills/j-<name>/SKILL.md's frontmatter `name:`
+# field is rewritten from `j.j-<name>` to `j.<name>`. A twin whose frontmatter does
+# not already read exactly `j.j-<name>` is treated as an error (aborts before any
+# write) rather than silently skipped or forced — the whole point of this
+# cross-check is that any twin already in an unexpected state must be looked at by
+# a human, not silently overwritten or silently left behind.
+#
+# Never touches the generated mirrors
+# --------------------------------------
+# This script only ever reads/writes under skills/. It has no code path that
+# touches .claude/skills/ or .agents/skills/ — those are regenerated by
+# /self-sync (E50_S15_T05), never hand-edited here, per CLAUDE.md's standing
+# read-only-mirror rule.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# This task's AC requires a clean default-level shellcheck run; SC1091 is an
+# info-level "did not follow sourced file" finding that would otherwise fail that
+# bar even though the sourced file does exist (see -x). Same fix already applied to
+# scripts/apply-j-prefix.sh and scripts/build-pages-site.sh.
+# shellcheck source=lib/resolve-project-dir.sh disable=SC1091
+source "$SCRIPT_DIR/../lib/resolve-project-dir.sh"
+
+PROJECT_DIR="$JENGA_PROJECT_DIR"
+SKILLS_DIR="$PROJECT_DIR/skills"
+
+# ---- Single named source: directory exception list (mirrors repoint-skill-refs.sh) ----
+DELETE_BARE_SKILL_DIRS_EXCEPTIONS=(jenga jenga-permission-level index)
+
+is_exception() {
+  local name="$1" ex
+  for ex in "${DELETE_BARE_SKILL_DIRS_EXCEPTIONS[@]}"; do
+    if [ "$name" = "$ex" ]; then
+      return 0
+    fi
+  done
+  return 1
+}
+
+# ---- Single named source: expected delete-set count (E50_S15_T01, 2026-09-19) ----
+EXPECTED_DELETE_COUNT=40
+
+usage() {
+  cat >&2 <<'EOF'
+Usage: delete-bare-skill-dirs.sh (--dry-run|--apply)
+
+  --dry-run   Report the computed delete set and planned frontmatter rewrites.
+              Writes nothing.
+  --apply     Delete every bare directory in the delete set and rewrite its
+              twin's frontmatter name: line, in one pass. Aborts with zero
+              writes if the live delete-set count does not match the recorded
+              expected count.
+EOF
+}
+
+MODE=""
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --dry-run)
+      MODE="dry-run"
+      shift
+      ;;
+    --apply)
+      MODE="apply"
+      shift
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      echo "delete-bare-skill-dirs.sh: error: unknown argument '$1'" >&2
+      usage
+      exit 1
+      ;;
+  esac
+done
+
+if [ -z "$MODE" ]; then
+  echo "delete-bare-skill-dirs.sh: error: exactly one of --dry-run or --apply is required" >&2
+  usage
+  exit 1
+fi
+
+# ============================================================================
+# 1. Live bare-vs-twin delta check — ALWAYS runs first, before any file I/O.
+# ============================================================================
+BARE_DIRS=()
+TWIN_NAMES=()
+UNPAIRED=()
+
+if [ -d "$SKILLS_DIR" ]; then
+  for d in "$SKILLS_DIR"/*/; do
+    [ -d "$d" ] || continue
+    name="$(basename "$d")"
+    case "$name" in
+      j-*)
+        TWIN_NAMES+=("${name#j-}")
+        continue
+        ;;
+    esac
+    BARE_DIRS+=("$name")
+  done
+fi
+
+is_twin_name() {
+  local target="$1" n
+  for n in "${TWIN_NAMES[@]-}"; do
+    [ -n "${n:-}" ] || continue
+    if [ "$n" = "$target" ]; then
+      return 0
+    fi
+  done
+  return 1
+}
+
+for name in "${BARE_DIRS[@]-}"; do
+  [ -n "${name:-}" ] || continue
+  if is_exception "$name"; then
+    continue
+  fi
+  if ! is_twin_name "$name"; then
+    UNPAIRED+=("$name")
+  fi
+done
+
+echo "== delete-bare-skill-dirs.sh: bare-vs-twin delta =="
+echo "  bare directories under skills/ (incl. exceptions): ${#BARE_DIRS[@]}"
+echo "  twin directories (skills/j-<name>/):                $(printf '%s\n' "${TWIN_NAMES[@]-}" | grep -c . || true)"
+if [ "${#UNPAIRED[@]}" -gt 0 ]; then
+  echo "  UNPAIRED bare directories (no twin, not on the exception list):"
+  for u in "${UNPAIRED[@]}"; do
+    echo "    - $u"
+  done
+  echo "delete-bare-skill-dirs.sh: error: the directory(ies) named above have no skills/j-<name>/ twin and are not on the exception list. Nothing was written. Disposition each one before running this script." >&2
+  exit 1
+fi
+echo "  delta check clean — every bare directory is either excepted or paired with a twin."
+echo
+
+# ============================================================================
+# 2. Compute the delete set: every bare, non-excepted directory with a twin.
+# ============================================================================
+DELETE_SET=()
+for name in "${BARE_DIRS[@]-}"; do
+  [ -n "${name:-}" ] || continue
+  if is_exception "$name"; then
+    continue
+  fi
+  DELETE_SET+=("$name")
+done
+
+# Sort for deterministic, reviewable output.
+if [ "${#DELETE_SET[@]}" -gt 0 ]; then
+  SORTED_DELETE_SET=()
+  while IFS= read -r n; do
+    [ -n "$n" ] || continue
+    SORTED_DELETE_SET+=("$n")
+  done < <(printf '%s\n' "${DELETE_SET[@]}" | sort)
+  DELETE_SET=("${SORTED_DELETE_SET[@]}")
+fi
+
+echo "== delete-bare-skill-dirs.sh: computed delete set =="
+echo "  count: ${#DELETE_SET[@]} (expected: $EXPECTED_DELETE_COUNT)"
+if [ "${#DELETE_SET[@]}" -ne "$EXPECTED_DELETE_COUNT" ]; then
+  echo "delete-bare-skill-dirs.sh: error: live delete-set count (${#DELETE_SET[@]}) does not match the recorded expected count ($EXPECTED_DELETE_COUNT, from E50_S15_T01's 2026-09-19 pre-flight recompute). Nothing was written. skills/ has drifted since that recompute -- re-run E50_S15_T01's checks before proceeding." >&2
+  exit 1
+fi
+for n in "${DELETE_SET[@]}"; do
+  echo "  - $n"
+done
+echo "  count check clean."
+echo
+
+# ============================================================================
+# 3. Pre-validate every twin's current frontmatter name: line before writing
+#    anything, in either mode -- an unexpected frontmatter state aborts the
+#    whole run rather than being silently skipped or forced.
+# ============================================================================
+PLANNED=()  # "name|old_line|new_line" per entry, in DELETE_SET order
+
+for name in "${DELETE_SET[@]}"; do
+  twin_skill_md="$SKILLS_DIR/j-$name/SKILL.md"
+  if [ ! -f "$twin_skill_md" ]; then
+    echo "delete-bare-skill-dirs.sh: error: expected twin file not found: $twin_skill_md. Nothing was written." >&2
+    exit 1
+  fi
+  current_line="$(grep -m1 -E '^name:[[:space:]]' "$twin_skill_md" || true)"
+  expected_old="name: j.j-${name}"
+  new_line="name: j.${name}"
+  if [ "$current_line" != "$expected_old" ]; then
+    echo "delete-bare-skill-dirs.sh: error: $twin_skill_md's frontmatter name: line reads '$current_line', expected exactly '$expected_old'. Nothing was written. This twin is in an unexpected state -- resolve it manually before re-running." >&2
+    exit 1
+  fi
+  PLANNED+=("${name}|${expected_old}|${new_line}")
+done
+
+echo "== delete-bare-skill-dirs.sh: planned frontmatter rewrites (${#PLANNED[@]}) =="
+for entry in "${PLANNED[@]}"; do
+  IFS='|' read -r name old_line new_line <<< "$entry"
+  echo "  skills/j-${name}/SKILL.md: '${old_line}' -> '${new_line}'"
+done
+echo
+
+if [ "$MODE" = "dry-run" ]; then
+  echo "== delete-bare-skill-dirs.sh: dry-run complete — ${#DELETE_SET[@]} director(ies) would be deleted, ${#PLANNED[@]} frontmatter line(s) would be rewritten =="
+  echo "  Bare directories that would be deleted:"
+  for name in "${DELETE_SET[@]}"; do
+    echo "    - skills/${name}/"
+  done
+  echo "  No files were written. Run with --apply to perform this (E50_S15_T04 only)."
+  exit 0
+fi
+
+# ============================================================================
+# 4. --apply: rewrite every twin's frontmatter FIRST (full pass), then delete
+#    every bare directory (full pass). Doing all rewrites before any delete
+#    means a mid-run failure during the rewrite pass leaves every bare
+#    directory still present (recoverable: nothing deleted yet), and a
+#    mid-run failure during the delete pass leaves every twin already
+#    correctly renamed (recoverable: re-run recomputes a smaller, still-valid
+#    delete set next time, since a twin with no more `j.j-` prefix simply
+#    won't re-match the pre-validation above for whichever entries already
+#    completed). Neither pass order can leave a "two directories claim
+#    j.<name>" state or a "no directory claims it" state uncommitted, because
+#    a bare directory is never deleted before its own twin's rename has
+#    already succeeded.
+# ============================================================================
+echo "== delete-bare-skill-dirs.sh: applying frontmatter rewrites =="
+for entry in "${PLANNED[@]}"; do
+  IFS='|' read -r name old_line new_line <<< "$entry"
+  twin_skill_md="$SKILLS_DIR/j-${name}/SKILL.md"
+  tmp_file="$(mktemp "${twin_skill_md}.rename.XXXXXX")"
+  cp -p "$twin_skill_md" "$tmp_file"
+  awk -v old="$old_line" -v new="$new_line" '
+    $0 == old && !done { print new; done=1; next }
+    { print }
+  ' "$twin_skill_md" > "$tmp_file"
+  mv "$tmp_file" "$twin_skill_md"
+  echo "  rewrote skills/j-${name}/SKILL.md"
+done
+echo
+
+echo "== delete-bare-skill-dirs.sh: deleting bare directories =="
+for name in "${DELETE_SET[@]}"; do
+  rm -rf "${SKILLS_DIR:?}/${name:?}"
+  echo "  deleted skills/${name}/"
+done
+echo
+
+echo "== delete-bare-skill-dirs.sh: apply complete — ${#DELETE_SET[@]} director(ies) deleted, ${#PLANNED[@]} frontmatter line(s) rewritten =="
+echo "  Working tree now needs a single commit covering both changes (this script does not commit)."
+exit 0

package/scripts/generate-legacy-shipped-paths.js

@@ -35,7 +35,7 @@
  *                 and unions it with the paths CURRENTLY on disk under this repo's own `skills/`
  *                 and `agents/` directories — i.e. "what this release is about to ship" folds into
  *                 the running cumulative record. This is the mode wired into the publish pipeline
- *                 (`skills/publish/scripts/npm_pipeline.sh` / `npm_ci_pipeline.sh`, via the
+ *                 (`skills/j-publish/scripts/npm_pipeline.sh` / `npm_ci_pipeline.sh`, via the
  *                 `generate:legacy-paths` npm script) so every future publish keeps the list
  *                 current with zero network dependency and zero publish-time registry flakiness.
  *
@@ -57,7 +57,7 @@
  *     "generated_at": "<ISO 8601>",
  *     "package": "@jenga-ai/agent",
  *     "source": "bootstrap-from-registry+incremental" | "incremental",
- *     "paths": ["agents/developer.md", "skills/do/SKILL.md", ...]
+ *     "paths": ["agents/developer.md", "skills/j-do/SKILL.md", ...]
  *   }
  *
  * `paths` are relative to a mirror root, POSIX-separated, deduped and sorted — matching the same

package/scripts/idea_manager.sh

@@ -3,15 +3,50 @@
 # Run from the repository root.
 
 IDEA_FILE="project/ideas.md"
-TEMPLATE="skills/idea/assets/idea_template.md"
+PLANS_DIR="project/documentation/plans"
+
+# PACKAGE_ROOT locates the package-shipped idea template (skills/j-idea/assets/).
+# This script always lives at scripts/, one level below the package root, in
+# both layouts:
+#   - this monorepo checkout
+#   - a consumer install, inside node_modules/@jenga-ai/agent/
+# BASH_SOURCE-derived resolution is exact in both cases (same reasoning as
+# scripts/jenga-permission-level-switch.sh's PACKAGE_ROOT derivation), with a
+# defensive node_modules-relative fallback matching the PKG_ROOT convention in
+# skills/init/scripts/init.sh, in case BASH_SOURCE resolution is ever
+# unavailable (e.g. the script is sourced rather than executed).
+PACKAGE_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TEMPLATE="$PACKAGE_ROOT/skills/j-idea/assets/idea_template.md"
+if [ ! -f "$TEMPLATE" ]; then
+  TEMPLATE="node_modules/@jenga-ai/agent/skills/j-idea/assets/idea_template.md"
+fi
 
 usage() {
   cat >&2 <<EOF
 Usage: $0 <subcommand> [args]
 
 Subcommands:
-  add "<entry>"    Append entry to project/ideas.md (auto-creates from template if missing)
-  list             Print all non-comment, non-blank entries (silent if file missing/empty)
+  add "<entry>"                          Append entry to project/ideas.md (auto-creates from
+                                          template if missing)
+  list                                   Print all non-comment, non-blank entries (silent if
+                                          file missing/empty)
+  tag "<idea-text>" <TAG>                Tag an existing idea line. <TAG> is either
+                                          "PROMOTED:E##_S##[_T##]" or "REJECTED". Errors if the
+                                          line is not found, is ambiguous, or is already tagged.
+  get-id "<idea-text>"                   Print the embedded board ID from a PROMOTED line
+                                          (errors if the line has no PROMOTED tag).
+  get-rapport "<idea-text>"              Print the source-rapport path recorded on the line via
+                                          a "<!-- rapport: <path> -->" comment. Prints nothing
+                                          (exit 0) if the line has no such comment.
+  resolve "<idea-text>" <promoted|rejected> [board_id]
+                                          The full outcome-record mechanism: tags the line, then
+                                          either updates the idea's source rapport (decision,
+                                          date, resulting board ID, [SPIKE]-prefixed title) or,
+                                          if the idea has no source rapport, creates
+                                          project/documentation/plans/<slug>_PROMOTED.md or
+                                          _REJECTED.md with the same content. board_id is
+                                          required for "promoted" and must be omitted for
+                                          "rejected".
 EOF
   exit 1
 }
@@ -23,6 +58,129 @@ real_entries() {
     | grep -v '^\s*<!--'
 }
 
+# find_idea_line <idea-text>
+# Prints "LINE_NUM:CONTENT" for the single line in $IDEA_FILE matching <idea-text> literally.
+# Errors (exit 1) if the file is missing, no line matches, or more than one line matches.
+find_idea_line() {
+  local needle="$1"
+  local matches
+  if [ ! -f "$IDEA_FILE" ]; then
+    echo "Error: $IDEA_FILE does not exist" >&2
+    return 1
+  fi
+  matches=$(grep -Fn -- "$needle" "$IDEA_FILE")
+  if [ -z "$matches" ]; then
+    echo "Error: no line in $IDEA_FILE matches: $needle" >&2
+    return 1
+  fi
+  if [ "$(printf '%s\n' "$matches" | wc -l | tr -d ' ')" -gt 1 ]; then
+    echo "Error: idea text matches multiple lines (ambiguous), refine it: $needle" >&2
+    return 1
+  fi
+  printf '%s\n' "$matches"
+}
+
+# tag_line <line-num> <tag-text>
+# Appends " <!-- <tag-text> -->" to the given line number of $IDEA_FILE, in place.
+# Uses awk string concatenation (not sed substitution) so arbitrary idea text/paths
+# containing &, /, or other sed-special characters are never re-interpreted.
+tag_line() {
+  local linenum="$1"
+  local tagtext="$2"
+  local tmpfile
+  tmpfile="${IDEA_FILE}.tmp.$$"
+  awk -v n="$linenum" -v suffix=" <!-- ${tagtext} -->" \
+    'NR==n { $0 = $0 suffix } { print }' "$IDEA_FILE" > "$tmpfile" && mv "$tmpfile" "$IDEA_FILE"
+}
+
+# slugify <text> — lowercase, non-alphanumeric runs collapsed to a single '-', trimmed, capped
+slugify() {
+  printf '%s' "$1" \
+    | tr '[:upper:]' '[:lower:]' \
+    | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//' \
+    | cut -c1-60
+}
+
+# extract_rapport_link <line-content> — prints the rapport: path, or nothing if absent
+extract_rapport_link() {
+  printf '%s' "$1" | grep -oE '<!-- rapport: [^>]*-->' | sed -E 's/<!-- rapport: *([^ ]+) *-->/\1/'
+}
+
+# extract_promoted_id <line-content> — prints the embedded board ID, or nothing if absent
+extract_promoted_id() {
+  printf '%s' "$1" | grep -oE '<!-- PROMOTED: [^>]*-->' | sed -E 's/<!-- PROMOTED: *([^ ]+) *-->/\1/'
+}
+
+# already_tagged <line-content> — returns 0 (true) if the line already has a terminal tag
+already_tagged() {
+  case "$1" in
+    *"<!-- PROMOTED"*|*"<!-- REJECTED"*) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+# validate_board_id <id> — loose shape check: E<digits> optionally _S<digits> optionally _T<digits>
+validate_board_id() {
+  case "$1" in
+    E[0-9]*) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+# update_rapport_outcome <rapport-path> <decision-label> <date> <board-id> <idea-text>
+# Prefixes the rapport's "# Rapport: ..." title with "[SPIKE] " if not already present, then
+# appends an "## Idea Outcome Record" section with the decision.
+update_rapport_outcome() {
+  local rapport_path="$1" decision_label="$2" today="$3" board_id="$4" idea_text="$5"
+  local tmpfile
+  tmpfile="${rapport_path}.tmp.$$"
+
+  awk '
+    /^# Rapport:/ && $0 !~ /\[SPIKE\]/ {
+      sub(/^# Rapport: /, "# Rapport: [SPIKE] ")
+    }
+    { print }
+  ' "$rapport_path" > "$tmpfile" && mv "$tmpfile" "$rapport_path"
+
+  {
+    echo ""
+    echo "---"
+    echo ""
+    echo "## Idea Outcome Record"
+    echo ""
+    echo "**Decision:** ${decision_label}"
+    echo "**Date:** ${today} (UTC)"
+    if [ "$decision_label" = "Promoted" ]; then
+      echo "**Resulting Board ID:** ${board_id}"
+    fi
+    echo "**Idea:** ${idea_text}"
+  } >> "$rapport_path"
+}
+
+# write_fallback_outcome <idea-text> <decision-label> <date> <board-id> <file-suffix>
+# Creates project/documentation/plans/<slug><file-suffix> and prints its path.
+write_fallback_outcome() {
+  local idea_text="$1" decision_label="$2" today="$3" board_id="$4" suffix="$5"
+  local slug outfile
+  slug=$(slugify "$idea_text")
+  mkdir -p "$PLANS_DIR"
+  outfile="${PLANS_DIR}/${slug}${suffix}"
+  {
+    echo "# Idea Outcome: ${idea_text}"
+    echo ""
+    echo "**Decision:** ${decision_label}"
+    echo "**Date:** ${today} (UTC)"
+    if [ "$decision_label" = "Promoted" ]; then
+      echo "**Resulting Board ID:** ${board_id}"
+    fi
+    echo ""
+    echo "## Idea"
+    echo ""
+    echo "${idea_text}"
+  } > "$outfile"
+  printf '%s' "$outfile"
+}
+
 case "${1:-}" in
   add)
     [ -z "${2:-}" ] && { echo "Error: add requires an entry argument" >&2; exit 1; }
@@ -41,6 +199,118 @@ case "${1:-}" in
     exit 0
     ;;
 
+  tag)
+    [ -z "${2:-}" ] && { echo "Error: tag requires an idea-text argument" >&2; exit 1; }
+    [ -z "${3:-}" ] && { echo "Error: tag requires a TAG argument (PROMOTED:E##_S##[_T##] or REJECTED)" >&2; exit 1; }
+    MATCH=$(find_idea_line "$2") || exit 1
+    LINENUM=$(printf '%s' "$MATCH" | cut -d: -f1)
+    CONTENT=$(printf '%s' "$MATCH" | cut -d: -f2-)
+    if already_tagged "$CONTENT"; then
+      echo "Error: idea line is already tagged; refusing to double-tag: $CONTENT" >&2
+      exit 1
+    fi
+    RAW_TAG="$3"
+    case "$RAW_TAG" in
+      PROMOTED:*)
+        BOARD_ID="${RAW_TAG#PROMOTED:}"
+        if ! validate_board_id "$BOARD_ID"; then
+          echo "Error: invalid board ID format in PROMOTED tag: $BOARD_ID (expected E##_S##[_T##] or E##)" >&2
+          exit 1
+        fi
+        TAG_TEXT="PROMOTED: $BOARD_ID"
+        ;;
+      REJECTED)
+        TAG_TEXT="REJECTED"
+        ;;
+      *)
+        echo "Error: TAG must be PROMOTED:E##_S##[_T##] or REJECTED, got: $RAW_TAG" >&2
+        exit 1
+        ;;
+    esac
+    tag_line "$LINENUM" "$TAG_TEXT"
+    echo "Tagged line $LINENUM: <!-- $TAG_TEXT -->"
+    ;;
+
+  get-id)
+    [ -z "${2:-}" ] && { echo "Error: get-id requires an idea-text argument" >&2; exit 1; }
+    MATCH=$(find_idea_line "$2") || exit 1
+    CONTENT=$(printf '%s' "$MATCH" | cut -d: -f2-)
+    ID=$(extract_promoted_id "$CONTENT")
+    if [ -z "$ID" ]; then
+      echo "Error: no PROMOTED tag found on matching line" >&2
+      exit 1
+    fi
+    echo "$ID"
+    ;;
+
+  get-rapport)
+    [ -z "${2:-}" ] && { echo "Error: get-rapport requires an idea-text argument" >&2; exit 1; }
+    MATCH=$(find_idea_line "$2") || exit 1
+    CONTENT=$(printf '%s' "$MATCH" | cut -d: -f2-)
+    extract_rapport_link "$CONTENT"
+    exit 0
+    ;;
+
+  resolve)
+    [ -z "${2:-}" ] && { echo "Error: resolve requires an idea-text argument" >&2; exit 1; }
+    [ -z "${3:-}" ] && { echo "Error: resolve requires a decision argument: promoted|rejected" >&2; exit 1; }
+    IDEA_TEXT="$2"
+    DECISION="$3"
+    BOARD_ID="${4:-}"
+
+    case "$DECISION" in
+      promoted|rejected) : ;;
+      *) echo "Error: decision must be 'promoted' or 'rejected', got: $DECISION" >&2; exit 1 ;;
+    esac
+
+    if [ "$DECISION" = "promoted" ]; then
+      [ -z "$BOARD_ID" ] && { echo "Error: promoted decision requires a board_id argument (E##_S##[_T##] or E##)" >&2; exit 1; }
+      if ! validate_board_id "$BOARD_ID"; then
+        echo "Error: invalid board ID format: $BOARD_ID" >&2
+        exit 1
+      fi
+    else
+      [ -n "$BOARD_ID" ] && { echo "Error: rejected decision does not take a board_id argument" >&2; exit 1; }
+    fi
+
+    MATCH=$(find_idea_line "$IDEA_TEXT") || exit 1
+    LINENUM=$(printf '%s' "$MATCH" | cut -d: -f1)
+    CONTENT=$(printf '%s' "$MATCH" | cut -d: -f2-)
+
+    if already_tagged "$CONTENT"; then
+      echo "Error: idea line is already tagged; refusing to re-resolve: $CONTENT" >&2
+      exit 1
+    fi
+
+    RAPPORT_PATH=$(extract_rapport_link "$CONTENT")
+
+    if [ "$DECISION" = "promoted" ]; then
+      TAG_TEXT="PROMOTED: $BOARD_ID"
+      DECISION_LABEL="Promoted"
+      FILE_SUFFIX="_PROMOTED.md"
+    else
+      TAG_TEXT="REJECTED"
+      DECISION_LABEL="Rejected"
+      FILE_SUFFIX="_REJECTED.md"
+    fi
+
+    TODAY=$(date -u +%Y-%m-%d)
+
+    tag_line "$LINENUM" "$TAG_TEXT"
+
+    if [ -n "$RAPPORT_PATH" ]; then
+      if [ ! -f "$RAPPORT_PATH" ]; then
+        echo "Error: source rapport not found at $RAPPORT_PATH; idea line was tagged but outcome record was not written" >&2
+        exit 1
+      fi
+      update_rapport_outcome "$RAPPORT_PATH" "$DECISION_LABEL" "$TODAY" "$BOARD_ID" "$IDEA_TEXT"
+      echo "Idea line $LINENUM tagged <!-- $TAG_TEXT -->; rapport updated: $RAPPORT_PATH"
+    else
+      OUTFILE=$(write_fallback_outcome "$IDEA_TEXT" "$DECISION_LABEL" "$TODAY" "$BOARD_ID" "$FILE_SUFFIX")
+      echo "Idea line $LINENUM tagged <!-- $TAG_TEXT -->; outcome record created: $OUTFILE"
+    fi
+    ;;
+
   *)
     usage
     ;;

package/scripts/mark-deployed.sh

@@ -13,7 +13,7 @@
 #   2. Derives each eligible ticket's matched EST-tagged commit SHAs (and,
 #      for parity/logging, their unioned touched-file list) using the
 #      identical anchored-grep + union technique
-#      skills/self-sync/scripts/mark-merged.sh already implements.
+#      skills/j-self-sync/scripts/mark-merged.sh already implements.
 #   3. Checks ANCESTRY, not diff-membership: a ticket is "covered" by a tag
 #      only when EVERY one of its matched commits is an ancestor of that
 #      tag's resolved_private_sha (git merge-base --is-ancestor). A tag
@@ -183,7 +183,7 @@ REPO_ROOT="$(git -C "$SCRIPT_DIR" rev-parse --show-toplevel 2>/dev/null || true)
 
 COMPUTE_SCRIPT="$SCRIPT_DIR/compute-deploy-reconcile.sh"
 WITH_LOCK_SCRIPT="$REPO_ROOT/scripts/with-lock.sh"
-UPDATE_FRONTMATTER_SCRIPT="$REPO_ROOT/skills/close-story/scripts/update-task-frontmatter.sh"
+UPDATE_FRONTMATTER_SCRIPT="$REPO_ROOT/skills/j-close-story/scripts/update-task-frontmatter.sh"
 MARKER_FILE="$REPO_ROOT/project/data/deploy-reconcile-marker.json"
 
 [ -f "$WITH_LOCK_SCRIPT" ] || die "expected script not found: $WITH_LOCK_SCRIPT"