aw-spec-cli 0.1.4 → 0.1.6

package/assets/.agents/skills/aw-spec-taskstoissues/SKILL.md

@@ -1,107 +0,0 @@
----
-name: "aw-spec-taskstoissues"
-description: "Convert existing tasks into actionable, dependency-ordered GitHub issues for the feature based on available design artifacts."
-argument-hint: "Optional filter or label for GitHub issues"
-compatibility: "Requires aw-spec project structure with .aw-spec/ directory"
-metadata:
-  author: "github-aw-spec"
-  source: "templates/commands/taskstoissues.md"
-user-invocable: true
-disable-model-invocation: false
----
-
-
-## User Input
-
-```text
-$ARGUMENTS
-```
-
-You **MUST** consider the user input before proceeding (if not empty).
-
-## Pre-Execution Checks
-
-**Check for extension hooks (before tasks-to-issues conversion)**:
-- Check if `.aw-spec/extensions.yml` exists in the project root.
-- If it exists, read it and look for entries under the `hooks.before_taskstoissues` key
-- If the YAML cannot be parsed or is invalid, skip hook checking silently and continue normally
-- Filter out hooks where `enabled` is explicitly `false`. Treat hooks without an `enabled` field as enabled by default.
-- For each remaining hook, do **not** attempt to interpret or evaluate hook `condition` expressions:
-  - If the hook has no `condition` field, or it is null/empty, treat the hook as executable
-  - If the hook defines a non-empty `condition`, skip the hook and leave condition evaluation to the HookExecutor implementation
-- When constructing slash commands from hook command names, replace dots (`.`) with hyphens (`-`). For example, `aw-spec.git.commit` → `/aw-spec-git-commit`.
-- For each executable hook, output the following based on its `optional` flag:
-  - **Optional hook** (`optional: true`):
-    ```
-    ## Extension Hooks
-
-    **Optional Pre-Hook**: {extension}
-    Command: `/{command}`
-    Description: {description}
-
-    Prompt: {prompt}
-    To execute: `/{command}`
-    ```
-  - **Mandatory hook** (`optional: false`):
-    ```
-    ## Extension Hooks
-
-    **Automatic Pre-Hook**: {extension}
-    Executing: `/{command}`
-    EXECUTE_COMMAND: {command}
-
-    Wait for the result of the hook command before proceeding to the Outline.
-    ```
-- If no hooks are registered or `.aw-spec/extensions.yml` does not exist, skip silently
-
-## Outline
-
-1. Run `.aw-spec/scripts/bash/check-prerequisites.sh --json --require-tasks --include-tasks` from repo root and parse FEATURE_DIR and AVAILABLE_DOCS list. All paths must be absolute. For single quotes in args like "I'm Groot", use escape syntax: e.g 'I'\''m Groot' (or double-quote if possible: "I'm Groot").
-1. **IF EXISTS**: Load `.aw-spec/memory/constitution.md` for project principles and governance constraints.
-1. From the executed script, extract the path to **tasks**.
-1. Get the Git remote by running:
-
-```bash
-git config --get remote.origin.url
-```
-
-> [!CAUTION]
-> ONLY PROCEED TO NEXT STEPS IF THE REMOTE IS A GITHUB URL
-
-1. For each task in the list, use the GitHub MCP server to create a new issue in the repository that is representative of the Git remote.
-
-> [!CAUTION]
-> UNDER NO CIRCUMSTANCES EVER CREATE ISSUES IN REPOSITORIES THAT DO NOT MATCH THE REMOTE URL
-
-## Post-Execution Checks
-
-**Check for extension hooks (after tasks-to-issues conversion)**:
-Check if `.aw-spec/extensions.yml` exists in the project root.
-- If it exists, read it and look for entries under the `hooks.after_taskstoissues` key
-- If the YAML cannot be parsed or is invalid, skip hook checking silently and continue normally
-- Filter out hooks where `enabled` is explicitly `false`. Treat hooks without an `enabled` field as enabled by default.
-- For each remaining hook, do **not** attempt to interpret or evaluate hook `condition` expressions:
-  - If the hook has no `condition` field, or it is null/empty, treat the hook as executable
-  - If the hook defines a non-empty `condition`, skip the hook and leave condition evaluation to the HookExecutor implementation
-- When constructing slash commands from hook command names, replace dots (`.`) with hyphens (`-`). For example, `aw-spec.git.commit` → `/aw-spec-git-commit`.
-- For each executable hook, output the following based on its `optional` flag:
-  - **Optional hook** (`optional: true`):
-    ```
-    ## Extension Hooks
-
-    **Optional Hook**: {extension}
-    Command: `/{command}`
-    Description: {description}
-
-    Prompt: {prompt}
-    To execute: `/{command}`
-    ```
-  - **Mandatory hook** (`optional: false`):
-    ```
-    ## Extension Hooks
-
-    **Automatic Hook**: {extension}
-    Executing: `/{command}`
-    EXECUTE_COMMAND: {command}
-    ```
-- If no hooks are registered or `.aw-spec/extensions.yml` does not exist, skip silently

package/assets/.aw-spec/domain.json

@@ -1,3 +0,0 @@
-{
-  "domain": ""
-}

package/assets/.aw-spec/extensions/.registry

@@ -1,19 +0,0 @@
-{
-  "schema_version": "1.0",
-  "extensions": {
-    "agent-context": {
-      "version": "1.0.0",
-      "source": "local",
-      "manifest_hash": "sha256:9a1dc02d2d0139bb03860392ecacef79183be2c442feda2f9ccaa4e5907b1e47",
-      "enabled": true,
-      "priority": 10,
-      "registered_commands": {
-        "claude": [
-          "aw-spec.agent-context.update"
-        ]
-      },
-      "registered_skills": [],
-      "installed_at": "2026-06-10T07:39:02.078494+00:00"
-    }
-  }
-}

package/assets/.aw-spec/extensions/agent-context/README.md

@@ -1,57 +0,0 @@
-# Coding Agent Context Extension
-
-This bundled extension manages the **coding agent context/instruction file** (e.g. `CLAUDE.md`, `.github/copilot-instructions.md`, `AGENTS.md`, `GEMINI.md`, …) for the active integration.
-
-It owns the lifecycle of the managed section delimited by the configurable start/end markers (defaults: `<!-- AW-SPEC START -->` / `<!-- AW-SPEC END -->`).
-
-## Why an extension?
-
-Not every AW-Spec user wants AW-Spec to write into the coding agent's context file. Extracting this behavior into a dedicated extension lets users:
-
-- **Opt out** entirely with `specify extension disable agent-context` — AW-Spec will then never create or modify the agent context file.
-- **Customize the markers** by editing `.aw-spec/extensions/agent-context/agent-context-config.yml` — both the Python layer and the bundled scripts honor the same `context_markers` value.
-- **Refresh on demand** with `/aw-spec.agent-context.update`, or automatically through the hooks declared in `extension.yml` (`after_specify`, `after_plan`).
-
-## Commands
-
-| Command | Description |
-|---------|-------------|
-| `aw-spec.agent-context.update` | Refresh the managed section in the agent context file with the current plan path. |
-
-## Configuration
-
-All configuration flows through the extension's own config file at
-`.aw-spec/extensions/agent-context/agent-context-config.yml`:
-
-```yaml
-# Path to the coding agent context file managed by this extension
-context_file: CLAUDE.md
-
-# Delimiters for the managed AW-Spec section
-context_markers:
-  start: "<!-- AW-SPEC START -->"
-  end: "<!-- AW-SPEC END -->"
-```
-
-- `context_file` — the project-relative path to the coding agent context file, written by `specify init` and `specify integration install`.
-- `context_markers.start` / `.end` — the delimiters around the managed section. Edit these to use custom markers.
-
-## Requirements
-
-The bundled update scripts require **Python 3** with **PyYAML** for YAML/upsert processing (PowerShell can also use `ConvertFrom-Yaml` when available).
-
-PyYAML ships with the `specify` CLI and is normally available via the same `python3` interpreter. If a hook reports *"PyYAML is required … not available in the current Python environment"*, it means the system `python3` differs from the one used to install AW-Spec. To resolve, run:
-
-```bash
-pip install pyyaml
-# or target the specific interpreter AW-Spec uses:
-/path/to/aw-spec-python -m pip install pyyaml
-```
-
-## Disable
-
-```bash
-specify extension disable agent-context
-```
-
-When disabled, AW-Spec skips context file creation, updates, and removal (the gates are inside `upsert_context_section()` and `remove_context_section()`).

package/assets/.aw-spec/extensions/agent-context/agent-context-config.yml

@@ -1,4 +0,0 @@
-context_file: CLAUDE.md
-context_markers:
-  start: <!-- AW-SPEC START -->
-  end: <!-- AW-SPEC END -->

package/assets/.aw-spec/extensions/agent-context/commands/aw-spec.agent-context.update.md

@@ -1,26 +0,0 @@
----
-description: "Refresh the managed AW-Spec section in the coding agent context file"
----
-
-# Update Coding Agent Context
-
-Refresh the managed AW-Spec section inside the active coding agent's context/instruction file (e.g. `CLAUDE.md`, `.github/copilot-instructions.md`, `AGENTS.md`).
-
-## Behavior
-
-The script reads the agent-context extension config at
-`.aw-spec/extensions/agent-context/agent-context-config.yml` to discover:
-
-- `context_file` — the path of the coding agent context file to manage.
-- `context_markers.start` / `.end` — the delimiters surrounding the managed section. Defaults to `<!-- AW-SPEC START -->` and `<!-- AW-SPEC END -->` when the field is missing.
-
-It then creates, replaces, or appends the managed block so that the section points at the most recent plan path when one can be discovered (`specs/<feature>/plan.md`).
-
-If `context_file` is empty or the file cannot be located, the command reports nothing to do and exits successfully.
-
-## Execution
-
-- **Bash**: `.aw-spec/extensions/agent-context/scripts/bash/update-agent-context.sh [plan_path]`
-- **PowerShell**: `.aw-spec/extensions/agent-context/scripts/powershell/update-agent-context.ps1 [plan_path]`
-
-When `plan_path` is omitted, the script auto-detects the most recently modified `specs/*/plan.md`.

package/assets/.aw-spec/extensions/agent-context/extension.yml

@@ -1,34 +0,0 @@
-schema_version: "1.0"
-
-extension:
-  id: agent-context
-  name: "Coding Agent Context"
-  version: "1.0.0"
-  description: "Manages coding agent context/instruction files (e.g., CLAUDE.md, copilot-instructions.md) with project-specific plan references and configurable markers"
-  author: aw-spec-core
-  repository: https://github.com/github/aw-spec
-  license: MIT
-
-requires:
-  aw-spec_version: ">=0.2.0"
-
-provides:
-  commands:
-    - name: aw-spec.agent-context.update
-      file: commands/aw-spec.agent-context.update.md
-      description: "Refresh the managed AW-Spec section in the coding agent context file"
-
-hooks:
-  after_specify:
-    command: aw-spec.agent-context.update
-    optional: true
-    description: "Refresh agent context after specification"
-  after_plan:
-    command: aw-spec.agent-context.update
-    optional: true
-    description: "Refresh agent context after planning"
-
-tags:
-  - "agent"
-  - "context"
-  - "core"

package/assets/.aw-spec/extensions/agent-context/scripts/bash/update-agent-context.sh

@@ -1,201 +0,0 @@
-#!/usr/bin/env bash
-# update-agent-context.sh
-#
-# Refresh the managed AW-Spec section in the coding agent's context file
-# (e.g. CLAUDE.md, .github/copilot-instructions.md, AGENTS.md).
-#
-# Reads `context_file` and `context_markers.{start,end}` from the
-# agent-context extension config:
-#   .aw-spec/extensions/agent-context/agent-context-config.yml
-#
-# Usage: update-agent-context.sh [plan_path]
-#
-# When `plan_path` is omitted, the script picks the most recently modified
-# `specs/*/plan.md` if any exist, otherwise emits the section without a
-# concrete plan path.
-
-set -euo pipefail
-
-PROJECT_ROOT="$(pwd)"
-EXT_CONFIG="$PROJECT_ROOT/.aw-spec/extensions/agent-context/agent-context-config.yml"
-DEFAULT_START="<!-- AW-SPEC START -->"
-DEFAULT_END="<!-- AW-SPEC END -->"
-
-if [[ ! -f "$EXT_CONFIG" ]]; then
-  echo "agent-context: $EXT_CONFIG not found; nothing to do." >&2
-  exit 0
-fi
-
-# Locate a suitable Python interpreter (python3, then python).
-_python=""
-if command -v python3 >/dev/null 2>&1; then
-  _python="python3"
-elif command -v python >/dev/null 2>&1 && python --version 2>&1 | grep -q "^Python 3"; then
-  _python="python"
-fi
-
-if [[ -z "$_python" ]]; then
-  echo "agent-context: Python 3 not found on PATH; skipping update." >&2
-  exit 0
-fi
-
-# Parse extension config once; emit three newline-separated fields:
-# context_file, context_markers.start, context_markers.end
-if ! _raw_opts="$("$_python" - "$EXT_CONFIG" <<'PY'
-import sys
-try:
-    import yaml
-except ImportError:
-    print(
-        "agent-context: PyYAML is required to parse extension config but is not available "
-        "in the current Python environment.\n"
-        "  To resolve: pip install pyyaml (or install it into the environment used by python3).\n"
-        "  Context file will not be updated until PyYAML is importable.",
-        file=sys.stderr,
-    )
-    sys.exit(2)
-try:
-    with open(sys.argv[1], "r", encoding="utf-8") as fh:
-        data = yaml.safe_load(fh)
-except Exception as exc:
-    print(
-        f"agent-context: unable to parse {sys.argv[1]} ({exc}); cannot update context.",
-        file=sys.stderr,
-    )
-    sys.exit(2)
-if not isinstance(data, dict):
-    data = {}
-def get_str(obj, *keys):
-    node = obj
-    for k in keys:
-        if isinstance(node, dict) and k in node:
-            node = node[k]
-        else:
-            return ""
-    return node if isinstance(node, str) else ""
-print(get_str(data, "context_file"))
-print(get_str(data, "context_markers", "start"))
-print(get_str(data, "context_markers", "end"))
-PY
-)"; then
-  echo "agent-context: skipping update (see above for details)." >&2
-  exit 0
-fi
-
-_opts_lines=()
-while IFS= read -r _line || [[ -n "$_line" ]]; do
-  _opts_lines+=("$_line")
-done < <(printf '%s\n' "$_raw_opts")
-if (( ${#_opts_lines[@]} < 3 )); then
-  echo "agent-context: malformed config parser output; expected 3 lines (context_file, marker_start, marker_end), got ${#_opts_lines[@]}; skipping update." >&2
-  exit 0
-fi
-CONTEXT_FILE="${_opts_lines[0]}"
-MARKER_START="${_opts_lines[1]}"
-MARKER_END="${_opts_lines[2]}"
-
-if [[ -z "$CONTEXT_FILE" ]]; then
-  echo "agent-context: context_file not set in extension config; nothing to do." >&2
-  exit 0
-fi
-
-# Reject absolute paths, backslash separators, and '..' path segments in context_file
-if [[ "$CONTEXT_FILE" == /* ]] || [[ "$CONTEXT_FILE" =~ ^[A-Za-z]: ]]; then
-  echo "agent-context: context_file must be a project-relative path; got '$CONTEXT_FILE'." >&2
-  exit 1
-fi
-if [[ "$CONTEXT_FILE" == *\\* ]]; then
-  echo "agent-context: context_file must not contain backslash separators; got '$CONTEXT_FILE'." >&2
-  exit 1
-fi
-IFS='/' read -ra _cf_parts <<< "$CONTEXT_FILE"
-for _seg in "${_cf_parts[@]}"; do
-  if [[ "$_seg" == ".." ]]; then
-    echo "agent-context: context_file must not contain '..' path segments; got '$CONTEXT_FILE'." >&2
-    exit 1
-  fi
-done
-unset _cf_parts _seg
-
-[[ -z "$MARKER_START" ]] && MARKER_START="$DEFAULT_START"
-[[ -z "$MARKER_END"   ]] && MARKER_END="$DEFAULT_END"
-
-PLAN_PATH="${1:-}"
-if [[ -z "$PLAN_PATH" ]]; then
-  # Pick the most recently modified plan.md two levels deep
-  # (specs/<Aggregate>/<Feature>/plan.md).
-  # Use find + sort by modification time to avoid ls/head fragility with
-  # spaces in paths or SIGPIPE from pipefail.
-  _plan_abs="$("$_python" - "$PROJECT_ROOT" <<'PY'
-import sys, os
-from pathlib import Path
-specs = Path(sys.argv[1]) / "specs"
-plans = sorted(
-    specs.glob("*/plan.md"),
-    key=lambda p: p.stat().st_mtime,
-    reverse=True,
-)
-print(plans[0] if plans else "")
-PY
-)"
-  if [[ -n "$_plan_abs" ]]; then
-    PLAN_PATH="${_plan_abs#"$PROJECT_ROOT/"}"
-  fi
-fi
-
-CTX_PATH="$PROJECT_ROOT/$CONTEXT_FILE"
-mkdir -p "$(dirname "$CTX_PATH")"
-
-# Build the managed section
-TMP_SECTION="$(mktemp)"
-trap 'rm -f "$TMP_SECTION"' EXIT
-{
-  echo "$MARKER_START"
-  echo "For additional context about technologies to be used, project structure,"
-  echo "shell commands, and other important information, read the current plan"
-  if [[ -n "$PLAN_PATH" ]]; then
-    echo "at $PLAN_PATH"
-  fi
-  echo "$MARKER_END"
-} > "$TMP_SECTION"
-
-"$_python" - "$CTX_PATH" "$MARKER_START" "$MARKER_END" "$TMP_SECTION" <<'PY'
-import sys, os
-ctx_path, start, end, section_path = sys.argv[1:5]
-with open(section_path, "r", encoding="utf-8") as fh:
-    section = fh.read().rstrip("\n") + "\n"
-
-if os.path.exists(ctx_path):
-    with open(ctx_path, "r", encoding="utf-8-sig") as fh:
-        content = fh.read()
-    s = content.find(start)
-    e = content.find(end, s if s != -1 else 0)
-    if s != -1 and e != -1 and e > s:
-        end_of_marker = e + len(end)
-        if end_of_marker < len(content) and content[end_of_marker] == "\r":
-            end_of_marker += 1
-        if end_of_marker < len(content) and content[end_of_marker] == "\n":
-            end_of_marker += 1
-        new_content = content[:s] + section + content[end_of_marker:]
-    elif s != -1:
-        new_content = content[:s] + section
-    elif e != -1:
-        end_of_marker = e + len(end)
-        if end_of_marker < len(content) and content[end_of_marker] == "\r":
-            end_of_marker += 1
-        if end_of_marker < len(content) and content[end_of_marker] == "\n":
-            end_of_marker += 1
-        new_content = section + content[end_of_marker:]
-    else:
-        if content and not content.endswith("\n"):
-            content += "\n"
-        new_content = (content + "\n" + section) if content else section
-else:
-    new_content = section
-
-new_content = new_content.replace("\r\n", "\n").replace("\r", "\n")
-with open(ctx_path, "wb") as fh:
-    fh.write(new_content.encode("utf-8"))
-PY
-
-echo "agent-context: updated $CONTEXT_FILE"