gsd-antigravity-kit 2.0.0 → 2.1.0

package/.agent/skills/gsd-converter/scripts/convert.py

@@ -490,7 +490,25 @@ def run_regression_tests(target_base):
     if not os.path.exists(test_script):
         # Create it if it doesn't exist (self-bootstrapping for this turn)
         with open(test_script, 'w', encoding='utf-8') as f:
-            f.write("""import os, re, sys
+            f.write("""import os, re, sys, io
+# Force UTF-8 for Windows
+if sys.platform == 'win32':
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+def get_command_category(cmd_name):
+    atomic = ['add-todo', 'check-todos', 'note', 'ship', 'cleanup', 'undo', 'help', 'do', 'stats', 'thread', 'session-report', 'join-discord']
+    phase = ['plan-phase', 'execute-phase', 'research-phase', 'validate-phase', 'discuss-phase', 'remove-phase', 'insert-phase', 'add-phase', 'list-phase-assumptions', 'secure-phase', 'ui-phase', 'ui-review', 'add-tests', 'workstreams']
+    milestone = ['new-milestone', 'complete-milestone', 'audit-milestone', 'milestone-summary', 'plan-milestone-gaps', 'review-backlog', 'add-backlog', 'plant-seed']
+    project = ['new-project', 'new-workspace', 'list-workspaces', 'remove-workspace', 'map-codebase', 'scan', 'intel', 'analyze-dependencies', 'explore', 'import']
+    system = ['gsd-tools', 'health', 'settings', 'profile-user', 'set-profile', 'update', 'pause-work', 'resume-work', 'reapply-patches', 'debug', 'forensics', 'manager', 'autonomous', 'fast', 'quick', 'code-review', 'code-review-fix', 'review', 'docs-update', 'pr-branch']
+    if cmd_name in atomic: return 'atomic'
+    if cmd_name in phase: return 'phase'
+    if cmd_name in milestone: return 'milestone'
+    if cmd_name in project: return 'project'
+    if cmd_name in system: return 'system'
+    return 'misc'
+
 def test_skill(base):
     print(f"  Checking {base}...")
     errors = []
@@ -508,19 +526,21 @@ def test_skill(base):
                     if 'gsd-source-version' not in content:
                         errors.append(f"Missing metadata in {f}")
                     # Check internal inclusions
-                    inclusions = re.findall(r"@references/commands/([^/]+?\\\\.md)", content)
-                    if inclusions:
-                        # Find where they should be
-                        cmd_name = inclusions[0][:-3]
-                        category = get_command_category(cmd_name)
-                        errors.append(f"Broken inclusive path in {f}: {inclusions[0]}. Should be {category}/{inclusions[0]}")
+                    inclusions = re.findall(r"@references/commands/([^/\\s]+?\.md)", content)
+                    for inc in inclusions:
+                        if not re.search(f"@references/commands/[^/]+/{inc}", content):
+                            cmd_name = inc[:-3]
+                            category = get_command_category(cmd_name)
+                            errors.append(f"Broken inclusive path in {f}: {inc}. Should be {category}/{inc}")
     return errors
 
 if __name__ == '__main__':
     target = sys.argv[1] if len(sys.argv) > 1 else '.'
     errs = test_skill(target)
     if errs:
-        for e in errs: print(f"  ❌ {e}")
+        for e in errs: 
+            try: print(f"  ❌ {e}")
+            except: print(f"  [ERR] {e}")
         sys.exit(1)
     print("  ✅ Regression tests passed.")
 """)
@@ -738,18 +758,12 @@ def main():
     # 2. Re-create the skill directory
     os.makedirs(target_base, exist_ok=True)
     
-    # 3. Perform migration and refactoring
+    # 3. Perform migration
     migrate_files(source_base, target_base, manifest)
     
-    refactor_content(target_base, new_version, manifest)
-    sync_mapping_docs(target_base, manifest)
-    optimize_gsd_tools(target_base)
-
-    # 4. Inject Dynamic Help Manifest
+    # 4. Inject Dynamic Help Manifest (Early for asset use)
     gsd_tools_source = os.path.join(source_base, 'get-shit-done/bin/gsd-tools.cjs')
     discovered_help = discover_commands(gsd_tools_source)
-    
-    # Dynamic gsd-tools help extraction for markdown
     gsd_tools_help_markdown = extract_gsd_tools_help(target_base)
 
     final_manifest = {
@@ -759,11 +773,12 @@ def main():
     }
     
     manifest_path = os.path.join(target_base, 'bin', 'help-manifest.json')
+    os.makedirs(os.path.dirname(manifest_path), exist_ok=True)
     with open(manifest_path, 'w', encoding='utf-8') as f:
         json.dump(final_manifest, f, indent=2)
     print("  ✅ Generated help-manifest.json dynamically from source")
 
-    # 5. Inject custom assets
+    # 5. Inject custom assets (BEFORE refactoring)
     script_dir = os.path.dirname(os.path.abspath(__file__))
     
     # Write VERSION file to skill root
@@ -785,6 +800,10 @@ def main():
             else:
                 shutil.copy2(asset_path, target_path)
 
+    # 6. Refactor and Optimize
+    refactor_content(target_base, new_version, manifest)
+    sync_mapping_docs(target_base, manifest)
+    optimize_gsd_tools(target_base)
     create_skill_md(target_base, skill_name, new_version)
     
     # 6. Final Verification

package/.agent/skills/gsd-converter/scripts/regression_test.py

@@ -1,33 +1,68 @@
-import os, re, sys
-def test_skill(base):
-    print(f"  Checking {base}...")
-    errors = []
-    # 1. Check categorized paths
-    cmd_dir = os.path.join(base, 'references', 'commands')
-    if not os.path.exists(cmd_dir): return ["Commands dir missing"]
-    
-    for root, dirs, files in os.walk(cmd_dir):
-        for f in files:
-            if f.endswith('.md'):
-                path = os.path.join(root, f)
-                with open(path, 'r', encoding='utf-8') as file:
-                    content = file.read()
-                    # Check metadata
-                    if 'gsd-source-version' not in content:
-                        errors.append(f"Missing metadata in {f}")
-                    # Check internal inclusions
-                    inclusions = re.findall(r"@references/commands/([^/]+?\\.md)", content)
-                    if inclusions:
-                        # Find where they should be
-                        cmd_name = inclusions[0][:-3]
-                        category = get_command_category(cmd_name)
-                        errors.append(f"Broken inclusive path in {f}: {inclusions[0]}. Should be {category}/{inclusions[0]}")
-    return errors
-
-if __name__ == '__main__':
-    target = sys.argv[1] if len(sys.argv) > 1 else '.'
-    errs = test_skill(target)
-    if errs:
-        for e in errs: print(f"  ❌ {e}")
-        sys.exit(1)
-    print("  ✅ Regression tests passed.")
+import os
+import re
+import sys
+import io
+
+# Force UTF-8
+if sys.platform == 'win32':
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+def get_command_category(cmd_name):
+    atomic = ['add-todo', 'check-todos', 'note', 'ship', 'cleanup', 'undo', 'help', 'do', 'stats', 'thread', 'session-report', 'join-discord']
+    phase = ['plan-phase', 'execute-phase', 'research-phase', 'validate-phase', 'discuss-phase', 'remove-phase', 'insert-phase', 'add-phase', 'list-phase-assumptions', 'secure-phase', 'ui-phase', 'ui-review', 'add-tests', 'workstreams']
+    milestone = ['new-milestone', 'complete-milestone', 'audit-milestone', 'milestone-summary', 'plan-milestone-gaps', 'review-backlog', 'add-backlog', 'plant-seed']
+    project = ['new-project', 'new-workspace', 'list-workspaces', 'remove-workspace', 'map-codebase', 'scan', 'intel', 'analyze-dependencies', 'explore', 'import']
+    system = ['gsd-tools', 'health', 'settings', 'profile-user', 'set-profile', 'update', 'pause-work', 'resume-work', 'reapply-patches', 'debug', 'forensics', 'manager', 'autonomous', 'fast', 'quick', 'code-review', 'code-review-fix', 'review', 'docs-update', 'pr-branch']
+    
+    if cmd_name in atomic: return 'atomic'
+    if cmd_name in phase: return 'phase'
+    if cmd_name in milestone: return 'milestone'
+    if cmd_name in project: return 'project'
+    if cmd_name in system: return 'system'
+    return 'misc'
+
+def test_skill(base):
+    print(f"  Checking {base}...")
+    errors = []
+    # 1. Check categorized paths
+    cmd_dir = os.path.join(base, 'references', 'commands')
+    if not os.path.exists(cmd_dir): return ["Commands dir missing"]
+    
+    for root, dirs, files in os.walk(cmd_dir):
+        for f in files:
+            if f.endswith('.md'):
+                path = os.path.join(root, f)
+                try:
+                    with open(path, 'r', encoding='utf-8') as file:
+                        content = file.read()
+                        # Check metadata
+                        if 'gsd-source-version' not in content:
+                            errors.append(f"Missing metadata in {f}")
+                        # Check internal inclusions
+                        # The regex in convert.py was r"@references/commands/([^/]+?\\.md)"
+                        # but in the Python string it was "@references/commands/([^/]+?\\\\.md)"
+                        # Let's use a simpler one.
+                        inclusions = re.findall(r"@references/commands/([^/\s]+?\.md)", content)
+                        for inc in inclusions:
+                            cmd_name = inc[:-3]
+                            expected_cat = get_command_category(cmd_name)
+                            # Check if the inclusion is @references/commands/category/cmd.md
+                            # The test in convert.py seemed to check if it's MISSING the category
+                            if not re.search(f"@references/commands/[^/]+/{inc}", content):
+                                errors.append(f"Broken inclusive path in {f}: {inc}. Should be {expected_cat}/{inc}")
+                except Exception as e:
+                    errors.append(f"Error reading {f}: {e}")
+    return errors
+
+if __name__ == '__main__':
+    target = sys.argv[1] if len(sys.argv) > 1 else '.agent/skills/gsd'
+    errs = test_skill(target)
+    if errs:
+        for e in errs: 
+            try:
+                print(f"  ❌ {e}")
+            except:
+                print(f"  [ERR] {e}")
+        sys.exit(1)
+    print("  ✅ Regression tests passed.")

package/README.md

@@ -3,8 +3,8 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![Antigravity Compatible](https://img.shields.io/badge/Antigravity-Compatible-purple.svg?logo=google&logoColor=white)](https://github.com/google-deepmind/antigravity)
 [![NPM Version](https://img.shields.io/npm/v/gsd-antigravity-kit.svg?logo=npm)](https://www.npmjs.com/package/gsd-antigravity-kit)
-[![Release Version](https://img.shields.io/badge/Release-v2.0.0-blue?style=flat-square)](https://github.com/dturkuler/GSD-Antigravity/releases/latest)
-[![GSD Version](https://img.shields.io/badge/gsd-v1.34.2-orange?style=flat-square)](https://github.com/glittercowboy/get-shit-done)
+[![Release Version](https://img.shields.io/badge/Release-v2.1.0-blue?style=flat-square)](https://github.com/dturkuler/GSD-Antigravity/releases/latest)
+[![GSD Version](https://img.shields.io/badge/gsd-v1.37.1-orange?style=flat-square)](https://github.com/glittercowboy/get-shit-done)
 
 **GSD-Antigravity Kit** is the official bootstrapping and management utility for the [Get Shit Done (GSD)](https://github.com/glittercowboy/get-shit-done) protocol within the Antigravity AI framework. It serves as a high-performance **Installer** and **Skill Manager** that provision, optimizes, and maintains GSD skills in your AG environment.
 
@@ -105,3 +105,4 @@ The core logic, philosophy, and original script engine were created by **[glitte
 
 
 
+

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "gsd-antigravity-kit",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Installer for GSD-Antigravity skills",
   "main": "index.js",
   "files": [
     "bin/",
-    ".agent/"
+    ".agent/rules/",
+    ".agent/skills/gsd/",
+    ".agent/skills/gsd-converter/"
   ],
   "bin": {
     "gsd-antigravity-kit": "bin/install.js"

package/.agent/skills/release-manager/SKILL.md

@@ -1,162 +0,0 @@
----
-name: release-manager
-description: Orchestrate the transition from "ready" to "released" for GSD-Antigravity. Manage version numbers in package.json, update changelogs, build release artifacts, and trigger Git tagging, GitHub releases, and NPM package publishing. Triggers on keywords like 'release', 'tagging', 'versioning', 'changelog update', and intents like 'perform a release' or 'prepare v1.0.1'.
----
-
-# Release Manager (Zero-Manual Automation)
-
-Comprehensive automation engine for managing the software release lifecycle for **gsd-antigravity-kit**. The orchestrator handles data integrity, automated documentation synchronization (Changelog/KB/README), and a one-click Git/NPM distribution process.
-
-## ⚡ Zero-Manual Execution
-This skill is designed for full automation. Initiating a release handles versioning, changelog generation, and publication in a single pass.
-
-1.  Finalize your features/fixes.
-2.  Run the orchestrator: `pwsh .agent/skills/release-manager/scripts/release.ps1`
-3.  The system will sync GSD, update docs, tag, push, and publish automatically.
-
-## Purpose
-To provide a deterministic, multi-phase procedure for transitioning the codebase from a "ready" state to a "tagged and released" state on GitHub and as a published package on NPM.
-
-## Prerequisites
-- **GitHub CLI (`gh`)**: 
-    - Check for local install: `.agent\skills\release-manager\bin\gh.exe`
-    - Check for global install: `gh`
-- **Authenticated**: Must be logged in (`.\.agent\bin\gh.exe auth login` or `gh auth login`).
-- **NPM**: Must be logged in to publish (`npm whoami`).
-
-## 🚀 Release Workflow
-
-### Phase 0: Readiness Check (CRITICAL)
-Before starting a release, ensure the following:
-1.  **Git Cleanliness**: Ensure `git status` is clean (no uncommitted changes except release prep).
-2.  **GSD Sync**: Run the converter to ensure `.agent/skills/gsd` is up-to-date with the latest `gsd-tools` discovery logic.
-    ```powershell
-    py .agent/skills/gsd-converter/scripts/convert.py gsd
-    ```
-3.  **Command Library Check**: Verify that `\.agent\skills\gsd\references\commands\` is populated with all migrated Skill documents (approx. 17+ files).
-4.  **Tests**: Run `npm test` if tests are defined.
-5.  **Auth Check (GitHub)**:
-    ```powershell
-    $ghPath = ".\.agent\skills\release-manager\bin\gh.exe"
-    if (-not (Test-Path $ghPath)) { $ghPath = "gh" }
-    & $ghPath auth status
-    ```
-6.  **Auth Check (NPM)**:
-    ```powershell
-    npm whoami
-    ```
-
-### Phase 1: Strategic Versioning (Auto-Increment)
-Determine the next version number. If not provided by the user, **default to PATCH** (e.g., 1.0.0 -> 1.0.1).
-
-**Command**:
-```powershell
-# Bump version in package.json without creating a git tag yet
-npm version patch --no-git-tag-version
-```
-
-### Phase 2: Documentation Synchronization (MANDATORY)
-**STOP**: You must ensure the release is fully documented before proceeding to GitHub.
-1.  **Changelog**: Ensure `CHANGELOG.md` is updated with all features, fixes, and the correct version number.
-2.  **Knowledgebase (KB)**: Update `docs/DEV_KNOWLEDGEBASE.md` using the **Knowledgebase Update Protocol**:
-    *   **Input**: Read `CHANGELOG.md` and `git log` for "Fixed" items.
-    *   **Analysis**: For each fix, identify **Context**, **Issue**, **Root Cause**, and **Technical Fix**.
-    *   **Output**: Append details under the version header in `docs/DEV_KNOWLEDGEBASE.md`.
-3.  **README**: Update `README.md` version badges and release summary.
-    *   **Action**: Search for `[![Release Version]` and update the version string in the badge URL.
-4.  **Verification**: Do not run Git commits or `gh release` until these files are saved and verified.
-
-### Phase 3: Archive & Package
-Create the release artifact for GitHub (Source Zip):
-1.  **Get Version**:
-    ```powershell
-    $package = Get-Content package.json | ConvertFrom-Json
-    $ver = $package.version
-    ```
-2.  **Archive**: Zip the repository content. We exclude local project data (`.planning`, `.antigravity`, `__tobedeleted`), temporary Git files, and the local `gh.exe` binary to keep the release lightweight.
-    ```powershell
-    $packageName = $package.name
-    $excludes = @("node_modules", ".git", "__tobedeleted", "*.zip", ".antigravity", ".planning", "*.bak", "gh.exe", ".agent/skills/release-manager/bin/gh.exe")
-    $files = Get-ChildItem -Path . -Exclude $excludes
-    Compress-Archive -Path $files -DestinationPath "$packageName_v$ver.zip" -Force
-    ```
-
-### Phase 4: Release Execution
-1.  **Commit**: Commit the version bump and doc updates: `git commit -am "chore: release v$ver"`
-2.  **Tag**: Create a git tag: `git tag "v$ver"`
-3.  **Push**: Push commits and tags: `git push && git push --tags`
-
-### Phase 5: GitHub Release (Automatic upload)
-Automatically create the release and upload the archive zip file.
-
-**Fix for Upload Issues**:
-We disable HTTP/2 (`$env:GODEBUG="http2client=0"`) to prevent "request body larger than specified content length" errors.
-
-**Command**:
-```powershell
-$ghPath = ".\.agent\skills\release-manager\bin\gh.exe"
-if (-not (Test-Path $ghPath)) { $ghPath = "gh" }
-$package = Get-Content package.json | ConvertFrom-Json
-$ver = $package.version
-$packageName = $package.name
-
-$env:GODEBUG="http2client=0"
-& $ghPath release create "v$ver" "$packageName`_v$ver.zip" --generate-notes
-```
-
-### Phase 6: NPM Publication
-1.  **Orchestrated Publish**: The `release.ps1` script will attempt `npm publish` automatically at the end of the workflow.
-2.  **Manual Fallback**: If the script is run with `--skipNpm` or fails, you can publish manually:
-    ```powershell
-    # For public packages
-    npm publish
-    ```
-
-**Verification**:
-```powershell
-npm info gsd-antigravity-kit version
-```
-
-### Phase 7: Release Cleanup
-Remove old ZIP files from the project root.
-```powershell
-$package = Get-Content package.json | ConvertFrom-Json
-$packageName = $package.name
-Get-ChildItem "$packageName`_v*.zip" | Sort-Object LastWriteTime -Descending | Select-Object -Skip 2 | Remove-Item -Force
-```
-
-## 🛠️ Interactive Checklist
-- [ ] **Phase 0: Readiness Check**
-    - [ ] Git Cleanliness
-    - [ ] GSD Sync (`convert.py gsd`)
-    - [ ] Verify `references/commands/` population
-    - [ ] `npm test` (if applicable)
-    - [ ] `gh auth status`
-    - [ ] `npm whoami`
-- [ ] **Phase 1: Strategic Versioning**
-    - [ ] `npm version patch --no-git-tag-version`
-- [ ] **Phase 2: Documentation Synchronization (Automated)**
-    - [ ] Update `CHANGELOG.md` (Self-writing via `release.ps1`)
-    - [ ] Update `docs/DEV_KNOWLEDGEBASE.md` (Fix summary via `release.ps1`)
-    - [ ] Update `README.md` (Badge URL replacement via `release.ps1`)
-- [ ] **Phase 3: Archive & Package**
-    - [ ] Create ZIP archive: `gsd-antigravity-kit_v1.0.X.zip`
-- [ ] **Phase 4: Release Execution**
-    - [ ] Git Commit & Tag
-    - [ ] Git Push
-- [ ] **Phase 5: GitHub Release**
-    - [ ] `gh release create ...` (with `GODEBUG=http2client=0`)
-- [ ] **Phase 6: NPM publication**
-    - [ ] `npm publish`
-- [ ] **Phase 7: Release Cleanup**
-    - [ ] Remove old local ZIPs
-
-## 🔍 Troubleshooting
-
-| Issue | Potential Cause | Fix |
-| :--- | :--- | :--- |
-| **`gh` command not found** | GitHub CLI missing. | Ensure `.agent\skills\release-manager\bin\gh.exe` exists or `gh` is in PATH. |
-| **Auth Error (GitHub)** | Token expired or not logged in. | Run `gh auth login`. |
-| **Auth Error (NPM)** | Not logged in. | Run `npm login`. |
-| **Upload Error (HTTP/2)** | `request body larger...` | Ensure `$env:GODEBUG="http2client=0"` is set. |
-| **NPM Name Conflict** | Package name taken. | Update `name` in `package.json`. |

package/.agent/skills/release-manager/bin/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2019 GitHub Inc.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/.agent/skills/release-manager/references/update_kb_from_fixes.md

@@ -1,29 +0,0 @@
-# Knowledgebase Update Protocol
-
-**Role:** You are the Lead Engineer analyzing the release for the Knowledgebase.
-**Goal:** Translate "Bug Fixes" from the Changelog/Git History into technical "Root Cause Analysis" entries.
-
-## Input
-1.  **Changelog:** Read `CHANGELOG.md` for the current version to identify "Fixed" items.
-2.  **Git History:** For each fix, search `git log --grep="<fix description>"` or `git diff` to see the actual code change.
-3.  **Chat session history:** analyze chat session history for more details about the issues and their fixes.
-
-## Analysis Logic
-For each "Fixed" item, determine:
-1.  **Context:** What component was broken? (e.g., Auth, PDF Engine).
-2.  **Issue:** What was the visible symptom?
-3.  **Root Cause:** *Why* was it broken? (e.g., "Race condition in hook", "Missing null check").
-4.  **Fix:** How was it solved technically? (e.g., "Added mutex", "Optional chaining").
-
-## Output Format
-Append to `docs/DEV_KNOWLEDGEBASE.md` under the new version header:
-
-```markdown
-### vX.Y.Z (YYYY-MM-DD)
-*   **Context:** <Component/Feature>
-*   **Issue:** <What was the user experience or error?>
-*   **Root Cause Analysis:** <Detailed technical explanation of WHY it happened>
-*   **How it was fixed:** <Technical implementation details of the solution>
-```
-
-**Instruction:** Perform this analysis NOW for the current release and update the file.