arckit-cli 6.1.1__py3-none-any.whl

arckit_cli-6.1.1.data/data/share/arckit/scripts/bump-version.sh

@@ -0,0 +1,293 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# bump-version.sh — Update all ArcKit version strings in one go.
+# Usage: ./scripts/bump-version.sh 2.14.0
+
+NEW_VERSION="${1:-}"
+
+# ── Validate input ──────────────────────────────────────────────────────────
+
+if [[ -z "$NEW_VERSION" ]]; then
+  echo "Usage: $0 <version>"
+  echo "Example: $0 2.14.0"
+  exit 1
+fi
+
+if ! [[ "$NEW_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  echo "Error: Version must be semver (X.Y.Z), got: $NEW_VERSION"
+  exit 1
+fi
+
+# ── Must run from repo root ─────────────────────────────────────────────────
+
+if [[ ! -f VERSION ]] || [[ ! -d plugins/arckit-claude ]]; then
+  echo "Error: Must be run from the arc-kit repo root."
+  exit 1
+fi
+
+OLD_VERSION=$(cat VERSION)
+echo "Bumping version: $OLD_VERSION → $NEW_VERSION"
+echo ""
+
+# ── Auto-discover all Claude Code plugins on disk ───────────────────────────
+#
+# Anything with .claude-plugin/plugin.json is a plugin. Splitting out the core
+# `arckit-claude` separately mirrors how the script (and marketplace.json)
+# treats it as the umbrella plugin all community overlays depend on.
+
+mapfile -t ALL_PLUGINS < <(
+  find . -maxdepth 4 -path '*/.claude-plugin/plugin.json' -not -path '*/node_modules/*' \
+    | sed -E 's|^\./||; s|/\.claude-plugin/plugin\.json$||' \
+    | sort
+)
+COMMUNITY_PLUGINS=()
+for p in "${ALL_PLUGINS[@]}"; do
+  [[ "$p" == "plugins/arckit-claude" ]] && continue
+  COMMUNITY_PLUGINS+=("$p")
+done
+
+if [[ ${#ALL_PLUGINS[@]} -eq 0 ]]; then
+  echo "Error: no plugins discovered on disk." >&2
+  exit 1
+fi
+
+# ── Drift check: every plugin on disk must be in marketplace.json ──────────
+#
+# bump-version.sh can sync versions but cannot fabricate marketplace entries
+# (description, keywords, etc.). Catches the v5.3.0 backfill gotcha where a
+# new plugin shipped without its marketplace entry.
+
+mapfile -t MARKETPLACE_PLUGIN_NAMES < <(
+  jq -r '.plugins[].name' .claude-plugin/marketplace.json | sort
+)
+MISSING_FROM_MARKETPLACE=()
+for p in "${ALL_PLUGINS[@]}"; do
+  plugin_name=$(jq -r '.name' "$p/.claude-plugin/plugin.json")
+  found=0
+  for m in "${MARKETPLACE_PLUGIN_NAMES[@]}"; do
+    [[ "$plugin_name" == "$m" ]] && { found=1; break; }
+  done
+  [[ $found -eq 0 ]] && MISSING_FROM_MARKETPLACE+=("$p ($plugin_name)")
+done
+
+if [[ ${#MISSING_FROM_MARKETPLACE[@]} -gt 0 ]]; then
+  echo "Error: plugin manifests exist on disk but are missing from .claude-plugin/marketplace.json:" >&2
+  for p in "${MISSING_FROM_MARKETPLACE[@]}"; do
+    echo "  - $p" >&2
+  done
+  echo "" >&2
+  echo "Add a marketplace.json entry (name, source, description, keywords, etc.) for each before re-running." >&2
+  exit 1
+fi
+
+UPDATED=0
+
+update_file() {
+  local file="$1"
+  local label="$2"
+  printf "  %-50s " "$file"
+  echo "✓ $label"
+  UPDATED=$((UPDATED + 1))
+}
+
+# ── 1. VERSION (plain text) ────────────────────────────────────────────────
+
+echo "$NEW_VERSION" > VERSION
+update_file "VERSION" "overwrite"
+
+# ── 2. pyproject.toml ──────────────────────────────────────────────────────
+
+sed -i -E "s/^version = \"[0-9]+\.[0-9]+\.[0-9]+\"/version = \"$NEW_VERSION\"/" pyproject.toml
+update_file "pyproject.toml" "version field"
+
+# ── 3. README.md (2 occurrences: badge-style link with version in text and URL) ──
+
+sed -i -E "s/\[v[0-9]+\.[0-9]+\.[0-9]+\]\(https:\/\/github\.com\/tractorjuice\/arc-kit\/releases\/tag\/v[0-9]+\.[0-9]+\.[0-9]+\)/[v$NEW_VERSION](https:\/\/github.com\/tractorjuice\/arc-kit\/releases\/tag\/v$NEW_VERSION)/g" README.md
+update_file "README.md" "release links (2 occurrences)"
+
+# ── 4. docs/README.md ──────────────────────────────────────────────────────
+
+sed -i -E "s/\*\*ArcKit Version\*\*: [0-9]+\.[0-9]+\.[0-9]+/**ArcKit Version**: $NEW_VERSION/" docs/README.md
+update_file "docs/README.md" "footer version"
+
+# ── 5. docs/index.html (version + month) ───────────────────────────────────
+
+MONTH_YEAR=$(date +"%B %Y")
+sed -i -E "s/Version [0-9]+\.[0-9]+\.[0-9]+ - [A-Za-z]+ [0-9]{4}/Version $NEW_VERSION - $MONTH_YEAR/" docs/index.html
+update_file "docs/index.html" "version + date → $MONTH_YEAR"
+
+# ── 6. plugins/arckit-claude/VERSION ───────────────────────────────────────
+
+echo "$NEW_VERSION" > plugins/arckit-claude/VERSION
+update_file "plugins/arckit-claude/VERSION" "overwrite"
+
+# ── 7. plugins/arckit-claude/.claude-plugin/plugin.json ────────────────────
+
+jq --arg v "$NEW_VERSION" '.version = $v' plugins/arckit-claude/.claude-plugin/plugin.json > plugins/arckit-claude/.claude-plugin/plugin.json.tmp
+mv plugins/arckit-claude/.claude-plugin/plugin.json.tmp plugins/arckit-claude/.claude-plugin/plugin.json
+update_file "plugins/arckit-claude/.claude-plugin/plugin.json" ".version"
+
+# ── 8. plugins/arckit-claude/.claude-plugin/marketplace.json ───────────────
+#
+# Standalone Claude marketplace metadata. The core plugin source is "." once
+# plugins/arckit-claude/ is mirrored to tractorjuice/arckit-claude; overlay
+# sources live under structured plugins/... paths in that standalone repo.
+
+jq --arg v "$NEW_VERSION" '.plugins |= map(.version = $v)' plugins/arckit-claude/.claude-plugin/marketplace.json > plugins/arckit-claude/.claude-plugin/marketplace.json.tmp
+mv plugins/arckit-claude/.claude-plugin/marketplace.json.tmp plugins/arckit-claude/.claude-plugin/marketplace.json
+update_file "plugins/arckit-claude/.claude-plugin/marketplace.json" "all .plugins[].version (metadata.version unchanged)"
+
+# ── 9. .claude-plugin/marketplace.json (all Claude plugin entries) ─────────
+#
+# All Claude plugins share one version; v6.0.0 publishes them together from
+# the standalone tractorjuice/arckit-claude marketplace repo.
+# metadata.version stays at 1.0.0.
+
+jq --arg v "$NEW_VERSION" '.plugins |= map(.version = $v)' .claude-plugin/marketplace.json > .claude-plugin/marketplace.json.tmp
+mv .claude-plugin/marketplace.json.tmp .claude-plugin/marketplace.json
+update_file ".claude-plugin/marketplace.json" "all .plugins[].version (metadata.version unchanged)"
+
+# ── 9a–9f. Community plugin manifests + VERSION files ─────────────────────
+#
+# Each community plugin pins its `arckit` dependency to the current core
+# version with an exact (`=`) semver constraint. bump-version.sh keeps
+# .version AND .dependencies[arckit].version in lockstep so all community
+# plugins always ship as a coherent set. Discovery is filesystem-driven:
+# any arckit-*/.claude-plugin/plugin.json directory is treated as a
+# community plugin (excluding the core arckit-claude).
+
+for plugin_dir in "${COMMUNITY_PLUGINS[@]}"; do
+  manifest="${plugin_dir}/.claude-plugin/plugin.json"
+  version_file="${plugin_dir}/VERSION"
+  if [[ -f "$manifest" ]]; then
+    jq --arg v "$NEW_VERSION" '
+      .version = $v
+      | .dependencies = (
+          (.dependencies // [])
+          | map(
+              # All ArcKit plugins (core + community overlays) ship in
+              # lockstep, so pin every inter-plugin "arckit*" dependency to
+              # the new version — not just the core "arckit" dependency.
+              # Covers community->community deps like arckit-au-energy -> arckit-au.
+              if type == "object" and ((.name // "") | startswith("arckit"))
+              then .version = "=" + $v
+              else .
+              end
+            )
+        )
+    ' "$manifest" > "${manifest}.tmp"
+    mv "${manifest}.tmp" "$manifest"
+    update_file "$manifest" ".version + .dependencies[arckit*].version"
+  fi
+  if [[ -f "$version_file" ]]; then
+    echo "$NEW_VERSION" > "$version_file"
+    update_file "$version_file" "overwrite"
+  fi
+done
+
+# ── 9. extensions/arckit-gemini/VERSION ───────────────────────────────────────────────
+
+echo "$NEW_VERSION" > extensions/arckit-gemini/VERSION
+update_file "extensions/arckit-gemini/VERSION" "overwrite"
+
+# ── 10. extensions/arckit-gemini/gemini-extension.json ────────────────────────────────
+
+jq --arg v "$NEW_VERSION" '.version = $v' extensions/arckit-gemini/gemini-extension.json > extensions/arckit-gemini/gemini-extension.json.tmp
+mv extensions/arckit-gemini/gemini-extension.json.tmp extensions/arckit-gemini/gemini-extension.json
+update_file "extensions/arckit-gemini/gemini-extension.json" ".version"
+
+# ── 11. extensions/arckit-opencode/VERSION ────────────────────────────────────────────
+
+echo "$NEW_VERSION" > extensions/arckit-opencode/VERSION
+update_file "extensions/arckit-opencode/VERSION" "overwrite"
+
+# ── 12. extensions/arckit-codex/VERSION ──────────────────────────────────────────────
+
+echo "$NEW_VERSION" > extensions/arckit-codex/VERSION
+update_file "extensions/arckit-codex/VERSION" "overwrite"
+
+# ── 13. extensions/arckit-copilot/VERSION ─────────────────────────────────────────────
+
+echo "$NEW_VERSION" > extensions/arckit-copilot/VERSION
+update_file "extensions/arckit-copilot/VERSION" "overwrite"
+
+# ── 14. extensions/arckit-paperclip/VERSION ──────────────────────────────────────────
+
+echo "$NEW_VERSION" > extensions/arckit-paperclip/VERSION
+update_file "extensions/arckit-paperclip/VERSION" "overwrite"
+
+# ── 15. extensions/arckit-vibe/VERSION ────────────────────────────────────────────
+
+echo "$NEW_VERSION" > extensions/arckit-vibe/VERSION
+update_file "extensions/arckit-vibe/VERSION" "overwrite"
+
+# ── 16. extensions/arckit-paperclip/package.json ─────────────────────────────────────
+
+if [[ -f extensions/arckit-paperclip/package.json ]]; then
+  jq --arg v "$NEW_VERSION" '.version = $v' extensions/arckit-paperclip/package.json > extensions/arckit-paperclip/package.json.tmp
+  mv extensions/arckit-paperclip/package.json.tmp extensions/arckit-paperclip/package.json
+  update_file "extensions/arckit-paperclip/package.json" ".version"
+fi
+
+# ── Summary ─────────────────────────────────────────────────────────────────
+
+echo ""
+echo "Updated $UPDATED files."
+echo ""
+
+# Verification
+echo "── Verification ──"
+echo ""
+echo "VERSION files:"
+VERSION_FILES=(VERSION)
+for p in "${ALL_PLUGINS[@]}"; do
+  [[ -f "$p/VERSION" ]] && VERSION_FILES+=("$p/VERSION")
+done
+# Extension repos (no plugin.json — added explicitly)
+for ext in extensions/arckit-gemini extensions/arckit-opencode extensions/arckit-codex extensions/arckit-copilot extensions/arckit-paperclip extensions/arckit-vibe; do
+  [[ -f "$ext/VERSION" ]] && VERSION_FILES+=("$ext/VERSION")
+done
+grep -H "$NEW_VERSION" "${VERSION_FILES[@]}"
+echo ""
+echo "pyproject.toml:"
+grep "^version" pyproject.toml
+echo ""
+echo "plugin.json (${#ALL_PLUGINS[@]} plugins):"
+for src in "${ALL_PLUGINS[@]}"; do
+  printf "  %-26s %s\n" "$src/plugin.json:" "$(jq -r '.version' "$src/.claude-plugin/plugin.json")"
+done
+echo ""
+echo "marketplace.json:"
+echo "  metadata.version:   $(jq -r '.metadata.version' .claude-plugin/marketplace.json)  (should be 1.0.0)"
+jq -r '.plugins[] | "  \(.name): \(.version)"' .claude-plugin/marketplace.json | sed 's/^/  /'
+echo ""
+echo "standalone Claude marketplace.json:"
+echo "  metadata.version:   $(jq -r '.metadata.version' plugins/arckit-claude/.claude-plugin/marketplace.json)  (should be 1.0.0)"
+jq -r '.plugins[] | "  \(.name): \(.version)"' plugins/arckit-claude/.claude-plugin/marketplace.json | sed 's/^/  /'
+echo ""
+
+# Lint check
+echo "── Lint ──"
+echo ""
+if npx markdownlint-cli2 "**/*.md" 2>&1; then
+  echo "  ✓ No lint errors"
+else
+  echo ""
+  echo "  ⚠ Lint errors found — fix before committing"
+fi
+echo ""
+
+# Reminders
+echo "── Reminders ──"
+echo ""
+echo "  CHANGELOG.md              — Add release notes manually"
+echo "  plugins/arckit-claude/CHANGELOG.md — Add release notes manually"
+echo ""
+echo "  Validate plugin/marketplace agreement (Claude Code v2.1.118+):"
+echo "    claude plugin tag plugins/arckit-claude --dry-run"
+echo ""
+echo "  Optional dependency cleanup before tagging:"
+echo "    claude plugin prune --dry-run"
+echo ""
+echo "Done."

arckit_cli-6.1.1.data/data/share/arckit/scripts/check_doctype_collisions.py

@@ -0,0 +1,30 @@
+#!/usr/bin/env python3
+"""Assert that every doc-type code in plugins/arckit-claude/config/doc-types.mjs is unique.
+
+No JS parser dependency — use a regex on the keys of the KNOWN_TYPES object.
+The format is stable:
+    'CODE': { name: '...', category: '...', regime: '...' }
+"""
+import re
+import sys
+from pathlib import Path
+
+src = Path("plugins/arckit-claude/config/doc-types.mjs").read_text()
+codes = re.findall(r"^\s*'([A-Z][A-Z0-9_-]*)':\s*\{", src, re.MULTILINE)
+
+if not codes:
+    print("FAIL: no doc-type codes found — regex may be out of date", file=sys.stderr)
+    sys.exit(2)
+
+seen = {}
+collisions = []
+for c in codes:
+    if c in seen:
+        collisions.append(c)
+    seen[c] = seen.get(c, 0) + 1
+
+if collisions:
+    print(f"FAIL: duplicate doc-type codes: {sorted(set(collisions))}", file=sys.stderr)
+    sys.exit(1)
+
+print(f"OK: {len(codes)} unique doc-type code(s)")

arckit_cli-6.1.1.data/data/share/arckit/scripts/check_recipes.py

@@ -0,0 +1,94 @@
+#!/usr/bin/env python3
+"""Validate every arckit-*/recipes/*.yaml file.
+
+Checks:
+- parses as YAML
+- has the required top-level keys (recipe, schema_version, targets, defaults.version)
+- has unique target IDs within the recipe
+- every target's `deps:` entries resolve to other target IDs in the same recipe
+  (glob patterns like "ADR-*" are accepted if at least one target matches)
+
+Exits non-zero if any check fails. Prints a one-line summary on success.
+"""
+import sys
+import glob
+import fnmatch
+
+try:
+    import yaml
+except ImportError:
+    print("ERROR: pyyaml not installed. Run: pip install pyyaml", file=sys.stderr)
+    sys.exit(2)
+
+REQUIRED_TOP_KEYS = {"recipe", "schema_version", "targets", "defaults"}
+
+errors = []
+recipes_checked = 0
+
+paths = sorted(
+    glob.glob("plugins/arckit-*/recipes/*.yaml")
+    + glob.glob("plugins/arckit-claude/skills/arckit-build/recipes/*.yaml")
+)
+
+for path in paths:
+    try:
+        with open(path) as f:
+            data = yaml.safe_load(f)
+    except yaml.YAMLError as e:
+        errors.append(f"{path}: YAML parse error: {e}")
+        continue
+
+    if not isinstance(data, dict):
+        errors.append(f"{path}: top-level must be a mapping")
+        continue
+
+    missing = REQUIRED_TOP_KEYS - set(data.keys())
+    if missing:
+        errors.append(f"{path}: missing required keys: {sorted(missing)}")
+        continue
+
+    if "version" not in data.get("defaults", {}):
+        errors.append(f"{path}: defaults.version is required")
+
+    targets = data.get("targets", [])
+    if not isinstance(targets, list):
+        errors.append(f"{path}: targets must be a list")
+        continue
+
+    target_ids = []
+    for t in targets:
+        if not isinstance(t, dict) or "id" not in t:
+            errors.append(f"{path}: target missing id field: {t!r}")
+            continue
+        target_ids.append(t["id"])
+
+    seen = set()
+    for tid in target_ids:
+        if tid in seen:
+            errors.append(f"{path}: duplicate target id: {tid}")
+        seen.add(tid)
+
+    target_id_set = set(target_ids)
+    for t in targets:
+        if not isinstance(t, dict):
+            continue
+        for dep in t.get("deps") or []:
+            if "*" in dep:
+                if not any(fnmatch.fnmatch(tid, dep) for tid in target_id_set):
+                    errors.append(
+                        f"{path}: target {t.get('id')}: glob dep {dep!r} matches no target"
+                    )
+            elif dep not in target_id_set:
+                errors.append(
+                    f"{path}: target {t.get('id')}: dep {dep!r} not a target in this recipe"
+                )
+
+    recipes_checked += 1
+
+if errors:
+    print(f"FAIL: {len(errors)} error(s) across {recipes_checked} recipe(s):", file=sys.stderr)
+    for e in errors:
+        print(f"  {e}", file=sys.stderr)
+    sys.exit(1)
+
+print(f"OK: {recipes_checked} recipe(s) validated")

arckit_cli-6.1.1.data/data/share/arckit/scripts/check_references.py

@@ -0,0 +1,144 @@
+#!/usr/bin/env python3
+"""Resolve every internal reference in the plugin source against disk.
+
+Walks `plugins/arckit-claude/` and checks that:
+
+  1. Every `${CLAUDE_PLUGIN_ROOT}/<path>` reference in a `.md` file resolves
+     to an existing file or directory inside `plugins/arckit-claude/`.
+  2. Every `handoffs[].command` entry in command frontmatter names an
+     existing command file under `plugins/arckit-claude/commands/`.
+  3. Every `${user_config.KEY}` reference names a key declared in
+     `plugins/arckit-claude/.claude-plugin/plugin.json` under `userConfig`.
+
+Exits non-zero on any broken reference. Run from repo root:
+
+    python3 scripts/check_references.py
+"""
+
+from __future__ import annotations
+
+import json
+import re
+import sys
+from pathlib import Path
+
+import yaml
+
+ROOT = Path(__file__).resolve().parents[1]
+PLUGIN = ROOT / "plugins" / "arckit-claude"
+PLUGIN_JSON = PLUGIN / ".claude-plugin" / "plugin.json"
+
+REF_RE = re.compile(r"\$\{CLAUDE_PLUGIN_ROOT\}/([^\s`\"')}\]<>]+)")
+USER_CONFIG_RE = re.compile(r"\$\{user_config\.([A-Za-z_][A-Za-z0-9_]*)\}")
+FRONTMATTER_RE = re.compile(r"\A---\s*\n(.*?)\n---\s*\n", re.DOTALL)
+
+
+def is_placeholder(path: str) -> bool:
+    """Skip patterns that are illustrative rather than concrete references."""
+    # Glob wildcards
+    if "*" in path or "?" in path:
+        return True
+    # Brace expansion {a,b} or angle/curly placeholders {NAME}, <name>
+    if "{" in path or "}" in path or "<" in path or ">" in path:
+        return True
+    return False
+
+
+def load_plugin_userconfig_keys() -> set[str]:
+    try:
+        data = json.loads(PLUGIN_JSON.read_text())
+    except (OSError, json.JSONDecodeError) as exc:
+        print(f"[error] cannot read {PLUGIN_JSON}: {exc}", file=sys.stderr)
+        return set()
+    return set((data.get("userConfig") or {}).keys())
+
+
+def iter_md_files() -> list[Path]:
+    return sorted(p for p in PLUGIN.rglob("*.md") if p.is_file())
+
+
+def line_of(text: str, offset: int) -> int:
+    return text.count("\n", 0, offset) + 1
+
+
+def check_plugin_root_refs(md_path: Path, text: str) -> list[tuple[int, str]]:
+    errors: list[tuple[int, str]] = []
+    for match in REF_RE.finditer(text):
+        rel = match.group(1).rstrip(".,;:)")
+        if is_placeholder(rel):
+            continue
+        target = PLUGIN / rel
+        if not target.exists():
+            errors.append((line_of(text, match.start()), f"${{CLAUDE_PLUGIN_ROOT}}/{rel}"))
+    return errors
+
+
+def check_user_config_refs(md_path: Path, text: str, known_keys: set[str]) -> list[tuple[int, str]]:
+    errors: list[tuple[int, str]] = []
+    for match in USER_CONFIG_RE.finditer(text):
+        key = match.group(1)
+        if key not in known_keys:
+            errors.append((line_of(text, match.start()), f"${{user_config.{key}}}"))
+    return errors
+
+
+def check_handoffs(md_path: Path, text: str, command_slugs: set[str]) -> list[tuple[int, str]]:
+    errors: list[tuple[int, str]] = []
+    fm_match = FRONTMATTER_RE.match(text)
+    if not fm_match:
+        return errors
+    try:
+        fm = yaml.safe_load(fm_match.group(1)) or {}
+    except yaml.YAMLError as exc:
+        return [(1, f"frontmatter YAML parse error: {exc}")]
+    handoffs = fm.get("handoffs")
+    if not isinstance(handoffs, list):
+        return errors
+    fm_line_count = fm_match.group(1).count("\n") + 2
+    for entry in handoffs:
+        if not isinstance(entry, dict):
+            continue
+        target = entry.get("command")
+        if isinstance(target, str) and target not in command_slugs:
+            errors.append((fm_line_count, f"handoffs: → /{target} (no such command)"))
+    return errors
+
+
+def main() -> int:
+    if not PLUGIN.is_dir():
+        print(f"[error] plugin source not found at {PLUGIN}", file=sys.stderr)
+        return 2
+
+    commands_dir = PLUGIN / "commands"
+    command_slugs = {p.stem for p in commands_dir.glob("*.md")}
+    known_user_config = load_plugin_userconfig_keys()
+
+    total_errors = 0
+    files_with_errors = 0
+
+    for md_path in iter_md_files():
+        text = md_path.read_text()
+        errors: list[tuple[int, str]] = []
+        errors.extend(check_plugin_root_refs(md_path, text))
+        errors.extend(check_user_config_refs(md_path, text, known_user_config))
+        if md_path.parent.name == "commands" and md_path.parent.parent == PLUGIN:
+            errors.extend(check_handoffs(md_path, text, command_slugs))
+        if errors:
+            files_with_errors += 1
+            total_errors += len(errors)
+            rel = md_path.relative_to(ROOT)
+            for line, ref in errors:
+                print(f"{rel}:{line}: broken reference: {ref}")
+
+    if total_errors:
+        print(
+            f"\n[fail] {total_errors} broken reference(s) across {files_with_errors} file(s)",
+            file=sys.stderr,
+        )
+        return 1
+    print(f"[ok] checked {len(iter_md_files())} markdown file(s); no broken references")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())