npm - @drafthq/draft - Versions diffs - 2.7.0 - Mend

@drafthq/draft 2.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (158) hide show

package/.claude-plugin/marketplace.json +38 -0
package/.claude-plugin/plugin.json +26 -0
package/LICENSE +21 -0
package/README.md +272 -0
package/bin/README.md +49 -0
package/cli/bin/draft.js +13 -0
package/cli/src/cli.js +113 -0
package/cli/src/hosts/claude-code.js +46 -0
package/cli/src/hosts/codex.js +33 -0
package/cli/src/hosts/cursor.js +50 -0
package/cli/src/hosts/index.js +24 -0
package/cli/src/hosts/opencode.js +39 -0
package/cli/src/installer.js +61 -0
package/cli/src/lib/fsx.js +34 -0
package/cli/src/lib/graph.js +23 -0
package/cli/src/lib/log.js +32 -0
package/cli/src/lib/paths.js +14 -0
package/core/agents/architect.md +338 -0
package/core/agents/debugger.md +193 -0
package/core/agents/ops.md +104 -0
package/core/agents/planner.md +158 -0
package/core/agents/rca.md +314 -0
package/core/agents/reviewer.md +256 -0
package/core/agents/writer.md +110 -0
package/core/guardrails/README.md +4 -0
package/core/guardrails/code-quality.md +4 -0
package/core/guardrails/dependency-triage.md +4 -0
package/core/guardrails/design-norms.md +4 -0
package/core/guardrails/language-standards.md +4 -0
package/core/guardrails/review-checks.md +4 -0
package/core/guardrails/secure-patterns.md +4 -0
package/core/guardrails/security.md +4 -0
package/core/guardrails.md +22 -0
package/core/knowledge-base.md +127 -0
package/core/methodology.md +1221 -0
package/core/shared/condensation.md +224 -0
package/core/shared/context-verify.md +44 -0
package/core/shared/cross-skill-dispatch.md +127 -0
package/core/shared/discovery-schema.md +75 -0
package/core/shared/draft-context-loading.md +282 -0
package/core/shared/git-report-metadata.md +106 -0
package/core/shared/graph-query.md +239 -0
package/core/shared/graph-usage-report.md +22 -0
package/core/shared/jira-sync.md +170 -0
package/core/shared/parallel-analysis.md +386 -0
package/core/shared/parallel-fanout.md +10 -0
package/core/shared/pattern-learning.md +146 -0
package/core/shared/red-flags.md +58 -0
package/core/shared/template-contract.md +22 -0
package/core/shared/template-hygiene.md +10 -0
package/core/shared/tool-resolver.md +10 -0
package/core/shared/vcs-commands.md +97 -0
package/core/shared/verification-gates.md +47 -0
package/core/templates/CHANGELOG.md +70 -0
package/core/templates/ai-context-export.md +8 -0
package/core/templates/ai-context.md +270 -0
package/core/templates/ai-profile.md +41 -0
package/core/templates/architecture.md +203 -0
package/core/templates/dependency-graph.md +103 -0
package/core/templates/discovery.md +79 -0
package/core/templates/guardrails.md +143 -0
package/core/templates/hld.md +327 -0
package/core/templates/intake-questions.md +403 -0
package/core/templates/jira.md +119 -0
package/core/templates/lld.md +283 -0
package/core/templates/metadata.json +66 -0
package/core/templates/plan.md +130 -0
package/core/templates/product.md +110 -0
package/core/templates/rca.md +86 -0
package/core/templates/root-architecture.md +127 -0
package/core/templates/root-product.md +53 -0
package/core/templates/root-tech-stack.md +117 -0
package/core/templates/service-index.md +55 -0
package/core/templates/session-summary.md +8 -0
package/core/templates/spec.md +165 -0
package/core/templates/tech-matrix.md +101 -0
package/core/templates/tech-stack.md +169 -0
package/core/templates/track-architecture.md +311 -0
package/core/templates/workflow.md +187 -0
package/integrations/agents/AGENTS.md +24384 -0
package/integrations/copilot/.github/copilot-instructions.md +24384 -0
package/integrations/gemini/.gemini.md +26 -0
package/package.json +53 -0
package/scripts/fetch-memory-engine.sh +116 -0
package/scripts/lib.sh +256 -0
package/scripts/tools/_lib.sh +220 -0
package/scripts/tools/adr-index.sh +117 -0
package/scripts/tools/check-graph-usage-report.sh +95 -0
package/scripts/tools/check-scope-conflicts.sh +139 -0
package/scripts/tools/check-skill-line-caps.sh +115 -0
package/scripts/tools/check-template-noop.sh +87 -0
package/scripts/tools/check-track-hygiene.sh +230 -0
package/scripts/tools/classify-files.sh +231 -0
package/scripts/tools/cycle-detect.sh +75 -0
package/scripts/tools/detect-test-framework.sh +135 -0
package/scripts/tools/diff-templates-vs-tracks.sh +176 -0
package/scripts/tools/emit-skill-metrics.sh +71 -0
package/scripts/tools/fix-whitespace.sh +192 -0
package/scripts/tools/freshness-check.sh +143 -0
package/scripts/tools/git-metadata.sh +203 -0
package/scripts/tools/graph-callers.sh +74 -0
package/scripts/tools/graph-impact.sh +93 -0
package/scripts/tools/graph-snapshot.sh +102 -0
package/scripts/tools/hotspot-rank.sh +75 -0
package/scripts/tools/manage-symlinks.sh +85 -0
package/scripts/tools/mermaid-from-graph.sh +92 -0
package/scripts/tools/migrate-track-frontmatter.sh +241 -0
package/scripts/tools/parse-git-log.sh +135 -0
package/scripts/tools/parse-reports.sh +114 -0
package/scripts/tools/render-track.sh +145 -0
package/scripts/tools/run-coverage.sh +153 -0
package/scripts/tools/scan-markers.sh +144 -0
package/scripts/tools/skill-caps.conf +24 -0
package/scripts/tools/validate-frontmatter.sh +125 -0
package/scripts/tools/verify-citations.sh +250 -0
package/scripts/tools/verify-doc-anchors.sh +204 -0
package/scripts/tools/verify-graph-binary.sh +154 -0
package/skills/GRAPH.md +332 -0
package/skills/adr/SKILL.md +374 -0
package/skills/assist-review/SKILL.md +49 -0
package/skills/bughunt/SKILL.md +668 -0
package/skills/bughunt/references/regression-tests.md +399 -0
package/skills/change/SKILL.md +267 -0
package/skills/coverage/SKILL.md +336 -0
package/skills/debug/SKILL.md +201 -0
package/skills/decompose/SKILL.md +656 -0
package/skills/deep-review/SKILL.md +326 -0
package/skills/deploy-checklist/SKILL.md +254 -0
package/skills/discover/SKILL.md +66 -0
package/skills/docs/SKILL.md +42 -0
package/skills/documentation/SKILL.md +197 -0
package/skills/draft/SKILL.md +177 -0
package/skills/draft/context-files.md +57 -0
package/skills/draft/intent-mapping.md +37 -0
package/skills/draft/quality-guide.md +51 -0
package/skills/graph/SKILL.md +107 -0
package/skills/impact/SKILL.md +86 -0
package/skills/implement/SKILL.md +794 -0
package/skills/incident-response/SKILL.md +245 -0
package/skills/index/SKILL.md +848 -0
package/skills/init/SKILL.md +1784 -0
package/skills/init/references/architecture-spec.md +1259 -0
package/skills/integrations/SKILL.md +53 -0
package/skills/jira/SKILL.md +577 -0
package/skills/jira/references/review.md +1322 -0
package/skills/learn/SKILL.md +478 -0
package/skills/new-track/SKILL.md +841 -0
package/skills/ops/SKILL.md +57 -0
package/skills/plan/SKILL.md +60 -0
package/skills/quick-review/SKILL.md +216 -0
package/skills/revert/SKILL.md +178 -0
package/skills/review/SKILL.md +1114 -0
package/skills/standup/SKILL.md +183 -0
package/skills/status/SKILL.md +183 -0
package/skills/tech-debt/SKILL.md +318 -0
package/skills/testing-strategy/SKILL.md +195 -0
package/skills/tour/SKILL.md +38 -0
package/skills/upload/SKILL.md +117 -0

package/scripts/tools/render-track.sh ADDED Viewed

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+# render-track.sh
+#
+# Render a Draft track's markdown set into a single HTML viewer artifact
+# on demand. Replaces the pre-2.0 pattern of checking generated HTML into
+# the track directory; viewer artifacts are now git-ignored and rebuilt
+# whenever a reader wants them.
+#
+# Usage:
+# scripts/tools/render-track.sh <track_dir> [--out <path>]
+# scripts/tools/render-track.sh <track_dir> --stdout
+#
+# Default output: <track_dir>/track-reader.html (git-ignored).
+#
+# Implementation note: pandoc is preferred if present; otherwise a minimal
+# markdown-to-HTML render is used via awk. No external network calls.
+set -euo pipefail
+if [ "${1:-}" = "--help" ] || [ "${1:-}" = "-h" ]; then
+    echo "${0##*/} — Foundations quality tool (see core/ docs for full behavior)"
+    exit 0
+fi
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=/dev/null
+source "$SCRIPT_DIR/_lib.sh"
+html_escape() {
+    local s="$1"
+    s="${s//&/&amp;}"
+    s="${s//</&lt;}"
+    s="${s//>/&gt;}"
+    printf '%s' "$s"
+}
+usage() {
+    local stream=2 code=2
+    if [[ "${USAGE_HELP_MODE:-0}" == 1 ]]; then stream=1; code=0; fi
+    sed -n '2,16p' "$0" >&$stream
+    exit "$code"
+}
+TRACK_DIR=""
+OUT_PATH=""
+TO_STDOUT=0
+while (($#)); do
+    case "$1" in
+        -h|--help) USAGE_HELP_MODE=1 usage ;;
+        --out) OUT_PATH="$2"; shift 2 ;;
+        --stdout) TO_STDOUT=1; shift ;;
+        -*) printf 'Unknown flag: %s\n' "$1" >&2; usage ;;
+        *) TRACK_DIR="$1"; shift ;;
+    esac
+done
+[[ -z "$TRACK_DIR" ]] && usage
+[[ ! -d "$TRACK_DIR" ]] && { printf 'Not a directory: %s\n' "$TRACK_DIR" >&2; exit 2; }
+TRACK_DIR="$(cd "$TRACK_DIR" && pwd)"
+track_id="$(basename "$TRACK_DIR")"
+if (( ! TO_STDOUT )) && [[ -z "$OUT_PATH" ]]; then
+    OUT_PATH="$TRACK_DIR/track-reader.html"
+fi
+# Pre-2.0 cleanup: warn if a stale HTML artifact is checked in.
+if (( ! TO_STDOUT )) && git -C "$TRACK_DIR" ls-files --error-unmatch \
+       "track-reader.html" >/dev/null 2>&1; then
+    printf 'render-track: WARNING — track-reader.html is checked into git.\n' >&2
+    printf ' Remove it: git rm tracks/.../track-reader.html\n' >&2
+    printf ' Draft 2.0 makes viewer artifacts git-ignored runtime output.\n' >&2
+fi
+ORDER=(spec.md plan.md hld.md lld.md discovery.md)
+ALL_MD=("${ORDER[@]}")
+# Append any extras found that are not already in ORDER.
+while IFS= read -r f; do
+    name="$(basename "$f")"
+    skip=0
+    for o in "${ORDER[@]}"; do [[ "$name" == "$o" ]] && skip=1 && break; done
+    (( skip )) || ALL_MD+=("$name")
+done < <(find "$TRACK_DIR" -maxdepth 1 -type f -name '*.md' | sort)
+render_with_pandoc() {
+    local title="$1"; shift
+    local files=()
+    for f in "$@"; do
+        [[ -f "$TRACK_DIR/$f" ]] && files+=("$TRACK_DIR/$f")
+    done
+    (( ${#files[@]} > 0 )) || return 1
+    pandoc -s --toc --metadata title="$title" "${files[@]}"
+}
+render_minimal() {
+    local title="$1"; shift
+    local files=()
+    for f in "$@"; do
+        [[ -f "$TRACK_DIR/$f" ]] && files+=("$TRACK_DIR/$f")
+    done
+    (( ${#files[@]} > 0 )) || return 1
+    printf '<!doctype html>\n<html><head><meta charset="utf-8">'
+    printf '<title>%s</title>' "$(html_escape "$title")"
+    cat <<'CSS'
+<style>
+body{font:14px/1.5 system-ui,sans-serif;max-width:920px;margin:2em auto;padding:0 1em;color:#222}
+h1,h2,h3{font-weight:600}h1{border-bottom:1px solid #ccc;padding-bottom:.3em}
+code{background:#f4f4f4;padding:.1em .3em;border-radius:3px;font-size:.95em}
+pre{background:#f8f8f8;padding:.8em;border-radius:5px;overflow-x:auto}
+table{border-collapse:collapse}td,th{border:1px solid #ddd;padding:.4em .6em}
+nav.toc{background:#fafafa;border:1px solid #eee;padding:.6em 1em;margin:1em 0}
+hr.docsep{margin:3em 0;border:0;border-top:2px dashed #ccc}
+.meta{color:#888;font-size:.9em}
+</style></head><body>
+CSS
+    printf '<h1>%s</h1>\n<nav class="toc"><strong>Documents</strong><ul>\n' "$(html_escape "$title")"
+    for f in "${files[@]}"; do
+        local n; n="$(basename "$f")"
+        printf '<li><a href="#%s">%s</a></li>\n' "$(html_escape "$n")" "$(html_escape "$n")"
+    done
+    printf '</ul></nav>\n'
+    for f in "${files[@]}"; do
+        local n; n="$(basename "$f")"
+        printf '<hr class="docsep"><section id="%s"><p class="meta">— %s —</p>\n<pre><code>' "$(html_escape "$n")" "$(html_escape "$n")"
+        sed -e 's/&/\&amp;/g' -e 's/</\&lt;/g' -e 's/>/\&gt;/g' "$f"
+        printf '</code></pre></section>\n'
+    done
+    printf '</body></html>\n'
+}
+OUTPUT=""
+if command -v pandoc >/dev/null 2>&1; then
+    OUTPUT="$(render_with_pandoc "Draft Track: $track_id" "${ALL_MD[@]}" || true)"
+fi
+if [[ -z "$OUTPUT" ]]; then
+    OUTPUT="$(render_minimal "Draft Track: $track_id" "${ALL_MD[@]}")"
+fi
+if (( TO_STDOUT )); then
+    printf '%s' "$OUTPUT"
+else
+    printf '%s' "$OUTPUT" > "$OUT_PATH"
+    printf 'Wrote %s (%d bytes)\n' "$OUT_PATH" "${#OUTPUT}"
+fi

package/scripts/tools/run-coverage.sh ADDED Viewed

@@ -0,0 +1,153 @@
+#!/usr/bin/env bash
+# run-coverage.sh — normalized coverage dispatcher.
+#
+# Dispatches to a language-specific coverage runner and emits a normalized
+# JSON report:
+# {language, tool, total:{lines,branches}, per_file:[{path,lines,branches,uncovered_lines}]}
+#
+# The actual coverage run is language-specific and may be slow. Use
+# `--schema-check` in CI to validate output shape without running tests.
+#
+# Usage:
+# scripts/tools/run-coverage.sh <language> [--path DIR]
+# [--schema-check]
+#
+# Languages: python (pytest --cov), go (go test -coverprofile), javascript (nyc), shell (n/a → 2)
+#
+# Exit codes: 0 OK, 1 invocation error, 2 tool unavailable (emits empty-schema JSON).
+set -euo pipefail
+LANGUAGE=""
+COVERAGE_PATH="."
+SCHEMA_CHECK="false"
+usage() {
+    cat <<'EOF'
+run-coverage.sh — normalized coverage report dispatcher.
+Usage:
+  scripts/tools/run-coverage.sh <language> [--path DIR] [--schema-check]
+Languages:
+  python pytest --cov (requires pytest-cov)
+  go go test -coverprofile
+  javascript nyc/c8 (via package.json)
+  shell not supported — emits schema-valid empty report (exit 2)
+Flags:
+  --path DIR Path to run coverage against (default: cwd).
+  --schema-check Emit schema-valid empty JSON without running any tests (for CI).
+  --help Show this help.
+Output schema (always present, even on exit 2):
+  {
+    "language": "<lang>",
+    "tool": "<coverage-tool>",
+    "total": {"lines": <float 0..1>, "branches": <float 0..1|null>},
+    "per_file": [{"path","lines","branches","uncovered_lines":[<int>...]}]
+  }
+EOF
+}
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --path) COVERAGE_PATH="$2"; shift 2;;
+        --schema-check) SCHEMA_CHECK="true"; shift;;
+        --help|-h) usage; exit 0;;
+        -*) echo "Unknown flag: $1" >&2; usage >&2; exit 1;;
+        *)
+            if [[ -z "$LANGUAGE" ]]; then
+                LANGUAGE="$1"; shift
+            else
+                echo "Unexpected positional arg: $1" >&2; exit 1
+            fi
+            ;;
+    esac
+done
+if [[ -z "$LANGUAGE" ]]; then
+    echo "ERROR: language is required (see --help)" >&2
+    exit 1
+fi
+emit_empty() {
+    local lang="$1" tool="$2"
+    printf '{"language":"%s","tool":"%s","total":{"lines":null,"branches":null},"per_file":[]}\n' \
+        "$lang" "$tool"
+}
+# Schema-only mode: never run the real coverage tool.
+if [[ "$SCHEMA_CHECK" == "true" ]]; then
+    case "$LANGUAGE" in
+        python) tool="pytest-cov";;
+        go) tool="go-cover";;
+        javascript) tool="nyc";;
+        typescript) tool="nyc";;
+        shell) tool="none";;
+        *)
+            echo "ERROR: unsupported language '$LANGUAGE'" >&2
+            exit 1
+            ;;
+    esac
+    emit_empty "$LANGUAGE" "$tool"
+    [[ "$LANGUAGE" == "shell" ]] && exit 2
+    exit 0
+fi
+case "$LANGUAGE" in
+    python)
+        if ! command -v pytest >/dev/null 2>&1; then
+            emit_empty python pytest-cov
+            exit 2
+        fi
+        # Run, capture JSON if coverage.py is available.
+        tmp_json="$(mktemp)"
+        trap 'rm -f "$tmp_json"' EXIT
+        (cd "$COVERAGE_PATH" && pytest --cov --cov-report=json:"$tmp_json" >/dev/null 2>&1) || true
+        if [[ -s "$tmp_json" ]] && command -v jq >/dev/null 2>&1; then
+            jq '{language:"python", tool:"pytest-cov",
+                 total:{lines: (.totals.percent_covered // 0) / 100, branches: null},
+                 per_file: (.files | to_entries | map({
+                    path: .key,
+                    lines: (.value.summary.percent_covered // 0) / 100,
+                    branches: null,
+                    uncovered_lines: (.value.missing_lines // [])
+                 }))}' "$tmp_json"
+            exit 0
+        fi
+        emit_empty python pytest-cov
+        exit 2
+        ;;
+    go)
+        if ! command -v go >/dev/null 2>&1; then
+            emit_empty go go-cover
+            exit 2
+        fi
+        tmp_cov="$(mktemp)"
+        trap 'rm -f "$tmp_cov"' EXIT
+        (cd "$COVERAGE_PATH" && go test -coverprofile="$tmp_cov" ./... >/dev/null 2>&1) || true
+        if [[ -s "$tmp_cov" ]]; then
+            total=$(go tool cover -func="$tmp_cov" 2>/dev/null | awk '/^total:/ {gsub(/%/, "", $3); print $3/100}')
+            total="${total:-null}"
+            printf '{"language":"go","tool":"go-cover","total":{"lines":%s,"branches":null},"per_file":[]}\n' \
+                "$total"
+            exit 0
+        fi
+        emit_empty go go-cover
+        exit 2
+        ;;
+    javascript|typescript)
+        # Real coverage via nyc/c8 is not yet wired — emit empty schema (exit 2)
+        # so consumers can degrade gracefully. See --schema-check for CI validation.
+        emit_empty "$LANGUAGE" nyc
+        exit 2
+        ;;
+    shell)
+        emit_empty shell none
+        exit 2
+        ;;
+    *)
+        echo "ERROR: unsupported language '$LANGUAGE'" >&2
+        exit 1
+        ;;
+esac

package/scripts/tools/scan-markers.sh ADDED Viewed

@@ -0,0 +1,144 @@
+#!/usr/bin/env bash
+# scan-markers.sh — find TODO/FIXME/HACK/XXX/DEPRECATED markers with blame age.
+#
+# Emits a JSON array. Per entry:
+# {path, line, marker, text, sha, author, introduced, age_days}
+#
+# Usage:
+# scripts/tools/scan-markers.sh [--root DIR] [--markers LIST]
+# [--min-age-days N] [--include-untracked]
+#
+# Exit codes: 0 OK (even with zero hits), 1 invocation error, 2 not a git repo
+# (emits [] on stdout so consumers can still parse).
+set -euo pipefail
+# shellcheck source=_lib.sh
+source "$(dirname "${BASH_SOURCE[0]}")/_lib.sh"
+ROOT="."
+MARKERS="TODO,FIXME,HACK,XXX,DEPRECATED"
+MIN_AGE=0
+usage() {
+    cat <<'EOF'
+scan-markers.sh — find code markers (TODO/FIXME/...) with git blame age.
+Usage:
+  scripts/tools/scan-markers.sh [--root DIR] [--markers LIST] [--min-age-days N]
+Flags:
+  --root DIR Root directory to scan (default: cwd).
+  --markers LIST Comma-separated marker list (default: TODO,FIXME,HACK,XXX,DEPRECATED).
+  --min-age-days N Only emit markers older than N days (default: 0).
+  --help Show this help.
+Output: JSON array of {path, line, marker, text, sha, author, introduced, age_days}.
+EOF
+}
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --root) ROOT="$2"; shift 2;;
+        --markers) MARKERS="$2"; shift 2;;
+        --min-age-days) MIN_AGE="$2"; shift 2;;
+        --help|-h) usage; exit 0;;
+        *) echo "Unknown flag: $1" >&2; usage >&2; exit 1;;
+    esac
+done
+if [[ ! -d "$ROOT" ]]; then
+    echo "ERROR: --root '$ROOT' is not a directory" >&2
+    exit 1
+fi
+cd "$ROOT"
+if ! git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
+    echo "[]"
+    exit 2
+fi
+# Build a regex like "\b(TODO|FIXME|HACK|XXX|DEPRECATED)\b"
+IFS=',' read -ra MARK_ARRAY <<<"$MARKERS"
+PATTERN_INNER="$(IFS='|'; echo "${MARK_ARRAY[*]}")"
+TMP="$(mktemp)"
+trap 'rm -f "$TMP"' EXIT
+# Prefer ripgrep; fall back to git grep.
+if command -v rg >/dev/null 2>&1; then
+    rg -n --no-heading -w -e "($PATTERN_INNER)" . >"$TMP" 2>/dev/null || true
+else
+    git grep -n -w -E "$PATTERN_INNER" -- . >"$TMP" 2>/dev/null || true
+fi
+NOW_SEC="$(date -u +%s)"
+emit_array() {
+    local first=true
+    printf '['
+    while IFS= read -r _ln; do
+        path="${_ln%%:*}"; rest="${_ln#*:}"; linenum="${rest%%:*}"; rest="${rest#*:}"
+        [[ -z "$path" || -z "$linenum" ]] && continue
+        # Skip binaries or tool's own output directory.
+        [[ "$path" == */.git/* ]] && continue
+        # Identify which marker matched first in this line (pure-bash, no fork).
+        marker=""
+        for m in "${MARK_ARRAY[@]}"; do
+            if [[ "$rest" == *"$m"* ]]; then
+                marker="$m"
+                break
+            fi
+        done
+        [[ -z "$marker" ]] && continue
+        # Trim whitespace from text
+        text="${rest#"${rest%%[![:space:]]*}"}"
+        text="${text%"${text##*[![:space:]]}"}"
+        # Limit text length
+        if [[ ${#text} -gt 300 ]]; then
+            text="${text:0:300}"
+        fi
+        # Blame info
+        sha="null"
+        author=""
+        introduced=""
+        age_days=0
+        if blame_line="$(git blame -L "$linenum,$linenum" --porcelain -- "$path" 2>/dev/null)"; then
+            blame_sha="$(echo "$blame_line" | head -1 | awk '{print $1}')"
+            if [[ -n "$blame_sha" && "$blame_sha" != "0000000000000000000000000000000000000000" ]]; then
+                sha="\"${blame_sha:0:7}\""
+                author="$(echo "$blame_line" | awk '/^author / {sub(/^author /,""); print; exit}')"
+                ts="$(echo "$blame_line" | awk '/^author-time / {print $2; exit}')"
+                if [[ -n "$ts" ]]; then
+                    introduced="$(date -u -d "@$ts" +%Y-%m-%d 2>/dev/null || date -u -r "$ts" +%Y-%m-%d 2>/dev/null || echo "")"
+                    age_days=$(( (NOW_SEC - ts) / 86400 ))
+                fi
+            fi
+        fi
+        if [[ "$age_days" -lt "$MIN_AGE" ]]; then
+            continue
+        fi
+        if $first; then first=false; else printf ','; fi
+        printf '\n {"path":"%s","line":%s,"marker":"%s","text":"%s","sha":%s,"author":"%s","introduced":"%s","age_days":%s}' \
+            "$(json_escape "$path")" \
+            "$linenum" \
+            "$marker" \
+            "$(json_escape "$text")" \
+            "$sha" \
+            "$(json_escape "$author")" \
+            "$(json_escape "$introduced")" \
+            "$age_days"
+    done <"$TMP"
+    if $first; then
+        printf ']\n'
+    else
+        printf '\n]\n'
+    fi
+}
+emit_array

package/scripts/tools/skill-caps.conf ADDED Viewed

@@ -0,0 +1,24 @@
+# scripts/tools/skill-caps.conf
+#
+# Per-skill max-line caps consumed by scripts/tools/check-skill-line-caps.sh.
+# Format: <skill-name> <max-lines>
+# Lines starting with '#' or blank lines are ignored.
+# `*` sets the global default cap when a skill is not listed.
+#
+# Initial caps (2026-05-17): warn-only mode. These reflect the WS-10
+# prompt-economy targets. Treat them as aspirational floors; tighten as
+# core/shared/*.md extraction lands. The validator runs in --enforce mode
+# only when invoked with the flag explicitly.
+# Default for any unlisted skill.
+*           600
+# Large generators — known oversized today; extraction work continues.
+init        3500
+status       1300
+bughunt     1200
+new-track   1100
+review      1000
+index        900
+implement    900
+decompose    700

package/scripts/tools/validate-frontmatter.sh ADDED Viewed

@@ -0,0 +1,125 @@
+#!/usr/bin/env bash
+# validate-frontmatter.sh — validate YAML frontmatter of a Markdown file.
+#
+# Checks:
+# 1. File starts with a "---" delimiter on line 1.
+# 2. A closing "---" delimiter exists.
+# 3. Every --require field is present as a top-level key.
+# 4. In --mode project-doc: rejects forbidden ephemeral fields (git.*, synced_to_commit)
+# that must live in draft/metadata.json instead of per-file frontmatter (WS-8).
+#
+# Usage:
+# scripts/tools/validate-frontmatter.sh <FILE> [--require FIELD[,FIELD...]]
+# [--mode project-doc]
+#
+# Exit codes: 0 valid, 1 invalid, 2 file not found.
+set -euo pipefail
+FILE=""
+REQUIRED=""
+MODE=""
+usage() {
+    cat <<'EOF'
+validate-frontmatter.sh — validate a Markdown file's YAML frontmatter.
+Usage:
+  scripts/tools/validate-frontmatter.sh <FILE> [--require FIELD[,FIELD...]]
+                                               [--mode project-doc]
+Flags:
+  --require LIST Comma-separated required top-level keys (default: name,description).
+  --mode project-doc Enforce WS-8: reject git.*, synced_to_commit, and dirty fields
+                      in per-file frontmatter. Use for draft/ project-level artifacts
+                      (architecture.md, .ai-context.md, product.md, etc.) whose git
+                      state must live in draft/metadata.json.
+  --help Show this help.
+Exit 0 valid, 1 invalid (writes diagnostics to stderr), 2 file not found.
+EOF
+}
+REQUIRED="name,description"
+while [[ $# -gt 0 ]]; do
+    case "$1" in
+        --require) REQUIRED="$2"; shift 2;;
+        --mode) MODE="$2"; shift 2;;
+        --help|-h) usage; exit 0;;
+        -*) echo "Unknown flag: $1" >&2; usage >&2; exit 1;;
+        *)
+            if [[ -z "$FILE" ]]; then FILE="$1"
+            else echo "Unexpected arg: $1" >&2; exit 1
+            fi
+            shift
+            ;;
+    esac
+done
+if [[ -z "$FILE" ]]; then
+    usage >&2
+    exit 1
+fi
+if [[ ! -f "$FILE" ]]; then
+    echo "ERROR: file not found: $FILE" >&2
+    exit 2
+fi
+IFS= read -r first_line <"$FILE" || true
+if [[ "$first_line" != "---" ]]; then
+    echo "ERROR: $FILE — missing opening '---' delimiter on line 1" >&2
+    exit 1
+fi
+if ! awk 'NR > 1 && /^---$/ { found=1; exit } END { exit !found }' "$FILE"; then
+    echo "ERROR: $FILE — missing closing '---' delimiter" >&2
+    exit 1
+fi
+frontmatter="$(awk '
+    NR == 1 && /^---$/ { in_fm = 1; next }
+    in_fm && /^---$/ { exit }
+    in_fm { print }
+' "$FILE")"
+# Validate each required field is present at top-level (no indentation).
+IFS=',' read -ra FIELDS <<<"$REQUIRED"
+MISSING=()
+for field in "${FIELDS[@]}"; do
+    field="${field// /}"
+    [[ -z "$field" ]] && continue
+    if ! printf '%s\n' "$frontmatter" | grep -qE "^${field}:"; then
+        MISSING+=("$field")
+    fi
+done
+if [[ ${#MISSING[@]} -gt 0 ]]; then
+    echo "ERROR: $FILE — missing required frontmatter fields: ${MISSING[*]}" >&2
+    exit 1
+fi
+# --mode project-doc: enforce WS-8 — no ephemeral git fields in per-file frontmatter.
+# These must live in draft/metadata.json. Any of the patterns below are violations.
+if [[ "$MODE" == "project-doc" ]]; then
+    FORBIDDEN=()
+    # Top-level git: block
+    if printf '%s\n' "$frontmatter" | grep -qE "^git:"; then
+        FORBIDDEN+=("git: (use draft/metadata.json)")
+    fi
+    # Top-level synced_to_commit:
+    if printf '%s\n' "$frontmatter" | grep -qE "^synced_to_commit:"; then
+        FORBIDDEN+=("synced_to_commit: (use draft/metadata.json)")
+    fi
+    # Top-level dirty: (legacy field)
+    if printf '%s\n' "$frontmatter" | grep -qE "^dirty:"; then
+        FORBIDDEN+=("dirty: (use draft/metadata.json:git.dirty)")
+    fi
+    if [[ ${#FORBIDDEN[@]} -gt 0 ]]; then
+        echo "ERROR: $FILE — forbidden ephemeral fields in project-doc frontmatter (WS-8): ${FORBIDDEN[*]}" >&2
+        echo " These fields must live in draft/metadata.json, not in per-file YAML frontmatter." >&2
+        exit 1
+    fi
+fi
+exit 0