aw-spec-cli 0.1.3 → 0.1.5

package/assets/.aw-spec/scripts/bash/aw-xref.sh

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# aw-xref.sh — thin wrapper: delegate to the single python core.
+#
+# Cross-reference (OKF dependency) substrate. Logic lives ONCE in
+# ../python/aw-xref.py; this wrapper exists only so the orchestrator's
+# execute_script (sh:/ps1: dispatch) can invoke it. Args pass through.
+#
+#   aw-xref.sh record         --using X --design <design.md> [--origin ...] [--date YYYY-MM-DD] [--root DIR]
+#   aw-xref.sh list           --aggregate Y [--root DIR] [--bundle knowledge]
+#   aw-xref.sh concept-upsert   --aggregate X [--source-files a,b,c] [--description D] [--origin ...] [--root DIR]
+#   aw-xref.sh concept-overview --aggregate X (--text PROSE | --text-file F) [--root DIR]
+#   aw-xref.sh concept-paths    --aggregate X | --feature-dir <dir> [--root DIR] [--bundle knowledge]
+set -euo pipefail
+DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+exec python3 "$DIR/../python/aw-xref.py" "$@"

package/assets/.aw-spec/scripts/bash/common.sh

@@ -39,26 +39,22 @@ get_repo_root() {
     (cd "$script_dir/../../.." && pwd)
 }
 
-# Get current feature name from explicit state only.
-# Returns the feature identifier or empty string if none is set.
-# Feature state is set by SPECIFY_FEATURE (from create-new-feature or
-# the git extension) or implicitly via .aw-spec/feature.json.
-get_current_branch() {
-    if [[ -n "${SPECIFY_FEATURE:-}" ]]; then
-        echo "$SPECIFY_FEATURE"
-        return
-    fi
-
-    # No explicit feature set — caller must handle this via feature.json
-    # in get_feature_paths(). Return empty to signal "unknown".
-    echo ""
-}
+# FEATURE RESOLUTION IS SINGLE-CHANNEL: `.aw-spec/feature.json`, written by
+# select-feature (and adopt), read back by read_feature_json_feature_directory below.
+# There is deliberately NO environment override. The retired get_feature_paths() +
+# get_current_branch() pair honoured SPECIFY_FEATURE_DIRECTORY / SPECIFY_FEATURE, but
+# they were dead code (zero callers) emitting the retired plan.md/tasks.md/research.md
+# document set, and PowerShell never implemented either variable — so the "override"
+# existed on one shell only and nothing in the pipeline could observe it. A second,
+# invisible channel would also let one step diverge from the feature every OTHER step
+# reads. Callers that need to act on a specific feature take an explicit `--feature-dir`
+# argument, which wins over feature.json at the call site.
 
 # Safely read .aw-spec/feature.json's "feature_directory" value.
 # Prints the raw value (possibly relative) to stdout, or empty string if the file
 # is missing, unparseable, or does not contain the key. Always returns 0 so callers
 # under `set -e` cannot be aborted by parser failure.
-# Parser order mirrors the historical get_feature_paths behavior: jq -> python3 -> grep/sed.
+# Parser order: jq -> python3 -> grep/sed.
 read_feature_json_feature_directory() {
     local repo_root="$1"
     local fj="$repo_root/.aw-spec/feature.json"
@@ -118,51 +114,6 @@ _persist_feature_json() {
     fi
 }
 
-get_feature_paths() {
-    local repo_root=$(get_repo_root)
-    local current_branch=$(get_current_branch)
-
-    # Resolve feature directory.  Priority:
-    #   1. SPECIFY_FEATURE_DIRECTORY env var (explicit override)
-    #   2. .aw-spec/feature.json "feature_directory" key (persisted by specify command)
-    #   3. Error — no feature context available
-    local feature_dir
-    if [[ -n "${SPECIFY_FEATURE_DIRECTORY:-}" ]]; then
-        feature_dir="$SPECIFY_FEATURE_DIRECTORY"
-        # Normalize relative paths to absolute under repo root
-        [[ "$feature_dir" != /* ]] && feature_dir="$repo_root/$feature_dir"
-        # Persist to feature.json so future sessions without the env var still work
-        _persist_feature_json "$repo_root" "$SPECIFY_FEATURE_DIRECTORY"
-    elif [[ -f "$repo_root/.aw-spec/feature.json" ]]; then
-        local _fd
-        _fd=$(read_feature_json_feature_directory "$repo_root")
-        if [[ -n "$_fd" ]]; then
-            feature_dir="$_fd"
-            # Normalize relative paths to absolute under repo root
-            [[ "$feature_dir" != /* ]] && feature_dir="$repo_root/$feature_dir"
-        else
-            echo "ERROR: Feature directory not found. Set SPECIFY_FEATURE_DIRECTORY or ensure .aw-spec/feature.json contains feature_directory." >&2
-            return 1
-        fi
-    else
-        echo "ERROR: Feature directory not found. Set SPECIFY_FEATURE_DIRECTORY or run the specify command to create .aw-spec/feature.json." >&2
-        return 1
-    fi
-
-    # Use printf '%q' to safely quote values, preventing shell injection
-    # via crafted branch names or paths containing special characters
-    printf 'REPO_ROOT=%q\n' "$repo_root"
-    printf 'CURRENT_BRANCH=%q\n' "$current_branch"
-    printf 'FEATURE_DIR=%q\n' "$feature_dir"
-    printf 'FEATURE_SPEC=%q\n' "$feature_dir/spec.md"
-    printf 'IMPL_PLAN=%q\n' "$feature_dir/plan.md"
-    printf 'TASKS=%q\n' "$feature_dir/tasks.md"
-    printf 'RESEARCH=%q\n' "$feature_dir/research.md"
-    printf 'DATA_MODEL=%q\n' "$feature_dir/data-model.md"
-    printf 'QUICKSTART=%q\n' "$feature_dir/quickstart.md"
-    printf 'CONTRACTS_DIR=%q\n' "$feature_dir/contracts"
-}
-
 # Check if jq is available for safe JSON construction
 has_jq() {
     command -v jq >/dev/null 2>&1

package/assets/.aw-spec/scripts/powershell/aw-inventory.ps1

@@ -0,0 +1,14 @@
+# aw-inventory.ps1 — thin wrapper: delegate to the single python core.
+#
+# The brownfield inventory logic lives ONCE in ../python/aw-inventory.py (a
+# faithful cross-platform port of Reference/okf-inventory.sh + aggregate-root
+# signals). This wrapper exists only so the orchestrator's execute_script,
+# which dispatches sh:/ps1: variants, can invoke it. All args (subcommand +
+# options) pass straight through.
+#
+#   aw-inventory.ps1 scan     [--root <dir>] [--out <path>] [--bundle <dir>] [--config <yml>]
+#   aw-inventory.ps1 validate --bundle <dir> [--repo-root <dir>]
+$ErrorActionPreference = "Stop"
+$core = Join-Path $PSScriptRoot "..\python\aw-inventory.py"
+& python3 $core @args
+exit $LASTEXITCODE

package/assets/.aw-spec/scripts/powershell/aw-parity.ps1

@@ -0,0 +1,13 @@
+# aw-parity.ps1 — thin wrapper: delegate to the single python core.
+#
+# Brownfield PARITY runner (the cutover gate). Logic lives ONCE in
+# ../python/aw-parity.py; this wrapper exists only so the orchestrator's
+# execute_script (sh:/ps1: dispatch) can invoke it. All args pass through.
+#
+#   aw-parity.ps1 scaffold --feature-dir <dir>
+#   aw-parity.ps1 check    --manifest <path>
+#   aw-parity.ps1 run      --manifest <path> [--out <report.md>]
+$ErrorActionPreference = "Stop"
+$core = Join-Path $PSScriptRoot "..\python\aw-parity.py"
+& python3 $core @args
+exit $LASTEXITCODE

package/assets/.aw-spec/scripts/powershell/aw-rev-constitution.ps1

@@ -0,0 +1,13 @@
+# aw-rev-constitution.ps1 — thin wrapper: delegate to the single python core.
+#
+# Brownfield GOVERN-BACKWARD substrate, driven by `/aw-spec-orch onboard` (the
+# standalone rev-constitution workflow is RETIRED). Logic lives
+# ONCE in ..\python\aw-rev-constitution.py; this wrapper exists only so the
+# orchestrator's execute_script (sh:/ps1: dispatch) can invoke it. Args pass through.
+#
+#   aw-rev-constitution.ps1 list-adopted [--root <dir>] [--specs <dir>] [--bundle <dir>]
+#   aw-rev-constitution.ps1 pack-setup   --name <domain> [--fallback <name>] [--root <dir>]
+$ErrorActionPreference = "Stop"
+$core = Join-Path $PSScriptRoot "..\python\aw-rev-constitution.py"
+& python3 $core @args
+exit $LASTEXITCODE