@runchr/gstack-antigravity 0.1.0

package/gstack-origin/test/telemetry.test.ts

@@ -0,0 +1,278 @@
+import { describe, test, expect, beforeEach, afterEach } from 'bun:test';
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+
+const ROOT = path.resolve(import.meta.dir, '..');
+const BIN = path.join(ROOT, 'bin');
+
+// Each test gets a fresh temp directory for GSTACK_STATE_DIR
+let tmpDir: string;
+
+function run(cmd: string, env: Record<string, string> = {}): string {
+  return execSync(cmd, {
+    cwd: ROOT,
+    env: { ...process.env, GSTACK_STATE_DIR: tmpDir, GSTACK_DIR: ROOT, ...env },
+    encoding: 'utf-8',
+    timeout: 10000,
+  }).trim();
+}
+
+function setConfig(key: string, value: string) {
+  run(`${BIN}/gstack-config set ${key} ${value}`);
+}
+
+function readJsonl(): string[] {
+  const file = path.join(tmpDir, 'analytics', 'skill-usage.jsonl');
+  if (!fs.existsSync(file)) return [];
+  return fs.readFileSync(file, 'utf-8').trim().split('\n').filter(Boolean);
+}
+
+function parseJsonl(): any[] {
+  return readJsonl().map(line => JSON.parse(line));
+}
+
+beforeEach(() => {
+  tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'gstack-tel-'));
+});
+
+afterEach(() => {
+  fs.rmSync(tmpDir, { recursive: true, force: true });
+});
+
+describe('gstack-telemetry-log', () => {
+  test('appends valid JSONL when tier=anonymous', () => {
+    setConfig('telemetry', 'anonymous');
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 142 --outcome success --session-id test-123`);
+
+    const events = parseJsonl();
+    expect(events).toHaveLength(1);
+    expect(events[0].v).toBe(1);
+    expect(events[0].skill).toBe('qa');
+    expect(events[0].duration_s).toBe(142);
+    expect(events[0].outcome).toBe('success');
+    expect(events[0].session_id).toBe('test-123');
+    expect(events[0].event_type).toBe('skill_run');
+    expect(events[0].os).toBeTruthy();
+    expect(events[0].gstack_version).toBeTruthy();
+  });
+
+  test('produces no output when tier=off', () => {
+    setConfig('telemetry', 'off');
+    run(`${BIN}/gstack-telemetry-log --skill ship --duration 30 --outcome success --session-id test-456`);
+
+    expect(readJsonl()).toHaveLength(0);
+  });
+
+  test('defaults to off for invalid tier value', () => {
+    setConfig('telemetry', 'invalid_value');
+    run(`${BIN}/gstack-telemetry-log --skill ship --duration 30 --outcome success --session-id test-789`);
+
+    expect(readJsonl()).toHaveLength(0);
+  });
+
+  test('includes installation_id for community tier', () => {
+    setConfig('telemetry', 'community');
+    run(`${BIN}/gstack-telemetry-log --skill review --duration 100 --outcome success --session-id comm-123`);
+
+    const events = parseJsonl();
+    expect(events).toHaveLength(1);
+    // installation_id should be a SHA-256 hash (64 hex chars)
+    expect(events[0].installation_id).toMatch(/^[a-f0-9]{64}$/);
+  });
+
+  test('installation_id is null for anonymous tier', () => {
+    setConfig('telemetry', 'anonymous');
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 50 --outcome success --session-id anon-123`);
+
+    const events = parseJsonl();
+    expect(events[0].installation_id).toBeNull();
+  });
+
+  test('includes error_class when provided', () => {
+    setConfig('telemetry', 'anonymous');
+    run(`${BIN}/gstack-telemetry-log --skill browse --duration 10 --outcome error --error-class timeout --session-id err-123`);
+
+    const events = parseJsonl();
+    expect(events[0].error_class).toBe('timeout');
+    expect(events[0].outcome).toBe('error');
+  });
+
+  test('handles missing duration gracefully', () => {
+    setConfig('telemetry', 'anonymous');
+    run(`${BIN}/gstack-telemetry-log --skill qa --outcome success --session-id nodur-123`);
+
+    const events = parseJsonl();
+    expect(events[0].duration_s).toBeNull();
+  });
+
+  test('supports event_type flag', () => {
+    setConfig('telemetry', 'anonymous');
+    run(`${BIN}/gstack-telemetry-log --event-type upgrade_prompted --skill "" --outcome success --session-id up-123`);
+
+    const events = parseJsonl();
+    expect(events[0].event_type).toBe('upgrade_prompted');
+  });
+
+  test('includes local-only fields (_repo_slug, _branch)', () => {
+    setConfig('telemetry', 'anonymous');
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 50 --outcome success --session-id local-123`);
+
+    const events = parseJsonl();
+    // These should be present in local JSONL
+    expect(events[0]).toHaveProperty('_repo_slug');
+    expect(events[0]).toHaveProperty('_branch');
+  });
+
+  test('creates analytics directory if missing', () => {
+    // Remove analytics dir
+    const analyticsDir = path.join(tmpDir, 'analytics');
+    if (fs.existsSync(analyticsDir)) fs.rmSync(analyticsDir, { recursive: true });
+
+    setConfig('telemetry', 'anonymous');
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 50 --outcome success --session-id mkdir-123`);
+
+    expect(fs.existsSync(analyticsDir)).toBe(true);
+    expect(readJsonl()).toHaveLength(1);
+  });
+});
+
+describe('.pending marker', () => {
+  test('finalizes stale .pending from another session as outcome:unknown', () => {
+    setConfig('telemetry', 'anonymous');
+
+    // Write a fake .pending marker from a different session
+    const analyticsDir = path.join(tmpDir, 'analytics');
+    fs.mkdirSync(analyticsDir, { recursive: true });
+    fs.writeFileSync(
+      path.join(analyticsDir, '.pending-old-123'),
+      '{"skill":"old-skill","ts":"2026-03-18T00:00:00Z","session_id":"old-123","gstack_version":"0.6.4"}'
+    );
+
+    // Run telemetry-log with a DIFFERENT session — should finalize the old pending marker
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 50 --outcome success --session-id new-456`);
+
+    const events = parseJsonl();
+    expect(events).toHaveLength(2);
+
+    // First event: finalized pending
+    expect(events[0].skill).toBe('old-skill');
+    expect(events[0].outcome).toBe('unknown');
+    expect(events[0].session_id).toBe('old-123');
+
+    // Second event: new event
+    expect(events[1].skill).toBe('qa');
+    expect(events[1].outcome).toBe('success');
+  });
+
+  test('.pending-SESSION file is removed after finalization', () => {
+    setConfig('telemetry', 'anonymous');
+
+    const analyticsDir = path.join(tmpDir, 'analytics');
+    fs.mkdirSync(analyticsDir, { recursive: true });
+    const pendingPath = path.join(analyticsDir, '.pending-stale-session');
+    fs.writeFileSync(pendingPath, '{"skill":"stale","ts":"2026-03-18T00:00:00Z","session_id":"stale-session","gstack_version":"v"}');
+
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 50 --outcome success --session-id new-456`);
+
+    expect(fs.existsSync(pendingPath)).toBe(false);
+  });
+
+  test('does not finalize own session pending marker', () => {
+    setConfig('telemetry', 'anonymous');
+
+    const analyticsDir = path.join(tmpDir, 'analytics');
+    fs.mkdirSync(analyticsDir, { recursive: true });
+    // Create pending for same session ID we'll use
+    const pendingPath = path.join(analyticsDir, '.pending-same-session');
+    fs.writeFileSync(pendingPath, '{"skill":"in-flight","ts":"2026-03-18T00:00:00Z","session_id":"same-session","gstack_version":"v"}');
+
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 50 --outcome success --session-id same-session`);
+
+    // Should only have 1 event (the new one), not finalize own pending
+    const events = parseJsonl();
+    expect(events).toHaveLength(1);
+    expect(events[0].skill).toBe('qa');
+  });
+
+  test('tier=off still clears own session pending', () => {
+    setConfig('telemetry', 'off');
+
+    const analyticsDir = path.join(tmpDir, 'analytics');
+    fs.mkdirSync(analyticsDir, { recursive: true });
+    const pendingPath = path.join(analyticsDir, '.pending-off-123');
+    fs.writeFileSync(pendingPath, '{"skill":"stale","ts":"2026-03-18T00:00:00Z","session_id":"off-123","gstack_version":"v"}');
+
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 50 --outcome success --session-id off-123`);
+
+    expect(fs.existsSync(pendingPath)).toBe(false);
+    // But no JSONL entries since tier=off
+    expect(readJsonl()).toHaveLength(0);
+  });
+});
+
+describe('gstack-analytics', () => {
+  test('shows "no data" for empty JSONL', () => {
+    const output = run(`${BIN}/gstack-analytics`);
+    expect(output).toContain('no data');
+  });
+
+  test('renders usage dashboard with events', () => {
+    setConfig('telemetry', 'anonymous');
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 120 --outcome success --session-id a-1`);
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 60 --outcome success --session-id a-2`);
+    run(`${BIN}/gstack-telemetry-log --skill ship --duration 30 --outcome error --error-class timeout --session-id a-3`);
+
+    const output = run(`${BIN}/gstack-analytics all`);
+    expect(output).toContain('/qa');
+    expect(output).toContain('/ship');
+    expect(output).toContain('2 runs');
+    expect(output).toContain('1 runs');
+    expect(output).toContain('Success rate: 66%');
+    expect(output).toContain('Errors: 1');
+  });
+
+  test('filters by time window', () => {
+    setConfig('telemetry', 'anonymous');
+    run(`${BIN}/gstack-telemetry-log --skill qa --duration 60 --outcome success --session-id t-1`);
+
+    const output7d = run(`${BIN}/gstack-analytics 7d`);
+    expect(output7d).toContain('/qa');
+    expect(output7d).toContain('last 7 days');
+  });
+});
+
+describe('gstack-telemetry-sync', () => {
+  test('exits silently with no endpoint configured', () => {
+    // Default: GSTACK_TELEMETRY_ENDPOINT is not set → exit 0
+    const result = run(`${BIN}/gstack-telemetry-sync`);
+    expect(result).toBe('');
+  });
+
+  test('exits silently with no JSONL file', () => {
+    const result = run(`${BIN}/gstack-telemetry-sync`, { GSTACK_TELEMETRY_ENDPOINT: 'http://localhost:9999' });
+    expect(result).toBe('');
+  });
+});
+
+describe('gstack-community-dashboard', () => {
+  test('shows unconfigured message when no Supabase config available', () => {
+    // Use a fake GSTACK_DIR with no supabase/config.sh
+    const output = run(`${BIN}/gstack-community-dashboard`, {
+      GSTACK_DIR: tmpDir,
+      GSTACK_SUPABASE_URL: '',
+      GSTACK_SUPABASE_ANON_KEY: '',
+    });
+    expect(output).toContain('Supabase not configured');
+    expect(output).toContain('gstack-analytics');
+  });
+
+  test('connects to Supabase when config exists', () => {
+    // Use the real GSTACK_DIR which has supabase/config.sh
+    const output = run(`${BIN}/gstack-community-dashboard`);
+    expect(output).toContain('gstack community dashboard');
+    // Should not show "not configured" since config.sh exists
+    expect(output).not.toContain('Supabase not configured');
+  });
+});

package/gstack-origin/test/touchfiles.test.ts

@@ -0,0 +1,262 @@
+/**
+ * Unit tests for diff-based test selection.
+ * Free (no API calls), runs with `bun test`.
+ */
+
+import { describe, test, expect } from 'bun:test';
+import { spawnSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import {
+  matchGlob,
+  selectTests,
+  detectBaseBranch,
+  E2E_TOUCHFILES,
+  LLM_JUDGE_TOUCHFILES,
+  GLOBAL_TOUCHFILES,
+} from './helpers/touchfiles';
+
+const ROOT = path.resolve(import.meta.dir, '..');
+
+// --- matchGlob ---
+
+describe('matchGlob', () => {
+  test('** matches any depth of path segments', () => {
+    expect(matchGlob('browse/src/commands.ts', 'browse/src/**')).toBe(true);
+    expect(matchGlob('browse/src/deep/nested/file.ts', 'browse/src/**')).toBe(true);
+    expect(matchGlob('browse/src/cli.ts', 'browse/src/**')).toBe(true);
+  });
+
+  test('** does not match unrelated paths', () => {
+    expect(matchGlob('browse/src/commands.ts', 'qa/**')).toBe(false);
+    expect(matchGlob('review/SKILL.md', 'qa/**')).toBe(false);
+  });
+
+  test('exact match works', () => {
+    expect(matchGlob('SKILL.md', 'SKILL.md')).toBe(true);
+    expect(matchGlob('SKILL.md.tmpl', 'SKILL.md')).toBe(false);
+    expect(matchGlob('qa/SKILL.md', 'SKILL.md')).toBe(false);
+  });
+
+  test('* matches within a single segment', () => {
+    expect(matchGlob('test/fixtures/review-eval-enum.rb', 'test/fixtures/review-eval-enum*.rb')).toBe(true);
+    expect(matchGlob('test/fixtures/review-eval-enum-diff.rb', 'test/fixtures/review-eval-enum*.rb')).toBe(true);
+    expect(matchGlob('test/fixtures/review-eval-vuln.rb', 'test/fixtures/review-eval-enum*.rb')).toBe(false);
+  });
+
+  test('dots in patterns are escaped correctly', () => {
+    expect(matchGlob('SKILL.md', 'SKILL.md')).toBe(true);
+    expect(matchGlob('SKILLxmd', 'SKILL.md')).toBe(false);
+  });
+
+  test('** at end matches files in the directory', () => {
+    expect(matchGlob('qa/SKILL.md', 'qa/**')).toBe(true);
+    expect(matchGlob('qa/SKILL.md.tmpl', 'qa/**')).toBe(true);
+    expect(matchGlob('qa/templates/report.md', 'qa/**')).toBe(true);
+  });
+});
+
+// --- selectTests ---
+
+describe('selectTests', () => {
+  test('browse/src change selects browse and qa tests', () => {
+    const result = selectTests(['browse/src/commands.ts'], E2E_TOUCHFILES);
+    expect(result.selected).toContain('browse-basic');
+    expect(result.selected).toContain('browse-snapshot');
+    expect(result.selected).toContain('qa-quick');
+    expect(result.selected).toContain('qa-fix-loop');
+    expect(result.selected).toContain('design-review-fix');
+    expect(result.reason).toBe('diff');
+    // Should NOT include unrelated tests
+    expect(result.selected).not.toContain('plan-ceo-review');
+    expect(result.selected).not.toContain('retro');
+    expect(result.selected).not.toContain('document-release');
+  });
+
+  test('skill-specific change selects only that skill and related tests', () => {
+    const result = selectTests(['plan-ceo-review/SKILL.md'], E2E_TOUCHFILES);
+    expect(result.selected).toContain('plan-ceo-review');
+    expect(result.selected).toContain('plan-ceo-review-selective');
+    expect(result.selected).toContain('plan-ceo-review-benefits');
+    expect(result.selected).toContain('autoplan-core');
+    expect(result.selected.length).toBe(4);
+    expect(result.skipped.length).toBe(Object.keys(E2E_TOUCHFILES).length - 4);
+  });
+
+  test('global touchfile triggers ALL tests', () => {
+    const result = selectTests(['test/helpers/session-runner.ts'], E2E_TOUCHFILES);
+    expect(result.selected.length).toBe(Object.keys(E2E_TOUCHFILES).length);
+    expect(result.skipped.length).toBe(0);
+    expect(result.reason).toContain('global');
+  });
+
+  test('gen-skill-docs.ts is a global touchfile', () => {
+    const result = selectTests(['scripts/gen-skill-docs.ts'], E2E_TOUCHFILES);
+    expect(result.selected.length).toBe(Object.keys(E2E_TOUCHFILES).length);
+    expect(result.reason).toContain('global');
+  });
+
+  test('unrelated file selects nothing', () => {
+    const result = selectTests(['README.md'], E2E_TOUCHFILES);
+    expect(result.selected).toEqual([]);
+    expect(result.skipped.length).toBe(Object.keys(E2E_TOUCHFILES).length);
+  });
+
+  test('empty changed files selects nothing', () => {
+    const result = selectTests([], E2E_TOUCHFILES);
+    expect(result.selected).toEqual([]);
+  });
+
+  test('multiple changed files union their selections', () => {
+    const result = selectTests(
+      ['plan-ceo-review/SKILL.md', 'retro/SKILL.md.tmpl'],
+      E2E_TOUCHFILES,
+    );
+    expect(result.selected).toContain('plan-ceo-review');
+    expect(result.selected).toContain('plan-ceo-review-selective');
+    expect(result.selected).toContain('retro');
+    expect(result.selected).toContain('retro-base-branch');
+    // Also selects journey routing tests (*/SKILL.md.tmpl matches retro/SKILL.md.tmpl)
+    expect(result.selected.length).toBeGreaterThanOrEqual(4);
+  });
+
+  test('works with LLM_JUDGE_TOUCHFILES', () => {
+    const result = selectTests(['qa/SKILL.md'], LLM_JUDGE_TOUCHFILES);
+    expect(result.selected).toContain('qa/SKILL.md workflow');
+    expect(result.selected).toContain('qa/SKILL.md health rubric');
+    expect(result.selected).toContain('qa/SKILL.md anti-refusal');
+    expect(result.selected.length).toBe(3);
+  });
+
+  test('SKILL.md.tmpl root template selects root-dependent tests and routing tests', () => {
+    const result = selectTests(['SKILL.md.tmpl'], E2E_TOUCHFILES);
+    // Should select the 7 tests that depend on root SKILL.md
+    expect(result.selected).toContain('skillmd-setup-discovery');
+    expect(result.selected).toContain('contributor-mode');
+    expect(result.selected).toContain('session-awareness');
+    // Also selects journey routing tests (SKILL.md.tmpl in their touchfiles)
+    expect(result.selected).toContain('journey-ideation');
+    // Should NOT select unrelated non-routing tests
+    expect(result.selected).not.toContain('plan-ceo-review');
+    expect(result.selected).not.toContain('retro');
+  });
+
+  test('global touchfiles work for LLM-judge tests too', () => {
+    const result = selectTests(['scripts/gen-skill-docs.ts'], LLM_JUDGE_TOUCHFILES);
+    expect(result.selected.length).toBe(Object.keys(LLM_JUDGE_TOUCHFILES).length);
+  });
+});
+
+// --- detectBaseBranch ---
+
+describe('detectBaseBranch', () => {
+  test('detects local main branch', () => {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'touchfiles-test-'));
+    const run = (cmd: string, args: string[]) =>
+      spawnSync(cmd, args, { cwd: dir, stdio: 'pipe', timeout: 5000 });
+
+    run('git', ['init']);
+    run('git', ['config', 'user.email', 'test@test.com']);
+    run('git', ['config', 'user.name', 'Test']);
+    fs.writeFileSync(path.join(dir, 'test.txt'), 'hello\n');
+    run('git', ['add', '.']);
+    run('git', ['commit', '-m', 'init']);
+
+    const result = detectBaseBranch(dir);
+    // Should find 'main' (or 'master' depending on git default)
+    expect(result).toMatch(/^(main|master)$/);
+
+    try { fs.rmSync(dir, { recursive: true, force: true }); } catch {}
+  });
+
+  test('returns null for empty repo with no branches', () => {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'touchfiles-test-'));
+    const run = (cmd: string, args: string[]) =>
+      spawnSync(cmd, args, { cwd: dir, stdio: 'pipe', timeout: 5000 });
+
+    run('git', ['init']);
+    // No commits = no branches
+    const result = detectBaseBranch(dir);
+    expect(result).toBeNull();
+
+    try { fs.rmSync(dir, { recursive: true, force: true }); } catch {}
+  });
+
+  test('returns null for non-git directory', () => {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'touchfiles-test-'));
+    const result = detectBaseBranch(dir);
+    expect(result).toBeNull();
+
+    try { fs.rmSync(dir, { recursive: true, force: true }); } catch {}
+  });
+});
+
+// --- Completeness: every testName in skill-e2e-*.test.ts has a TOUCHFILES entry ---
+
+describe('TOUCHFILES completeness', () => {
+  test('every E2E testName has a TOUCHFILES entry', () => {
+    // Read all split E2E test files
+    const testDir = path.join(ROOT, 'test');
+    const e2eFiles = fs.readdirSync(testDir).filter(f => f.startsWith('skill-e2e-') && f.endsWith('.test.ts'));
+    let e2eContent = '';
+    for (const f of e2eFiles) {
+      e2eContent += fs.readFileSync(path.join(testDir, f), 'utf-8') + '\n';
+    }
+
+    // Extract all testName: 'value' entries
+    const testNameRegex = /testName:\s*['"`]([^'"`]+)['"`]/g;
+    const testNames: string[] = [];
+    let match;
+    while ((match = testNameRegex.exec(e2eContent)) !== null) {
+      let name = match[1];
+      // Handle template literals like `qa-${label}` — these expand to
+      // qa-b6-static, qa-b7-spa, qa-b8-checkout
+      if (name.includes('${')) continue; // skip template literals, check expanded forms below
+      testNames.push(name);
+    }
+
+    // Add the template-expanded testNames from runPlantedBugEval calls
+    const plantedBugRegex = /runPlantedBugEval\([^,]+,\s*[^,]+,\s*['"`]([^'"`]+)['"`]\)/g;
+    while ((match = plantedBugRegex.exec(e2eContent)) !== null) {
+      testNames.push(`qa-${match[1]}`);
+    }
+
+    expect(testNames.length).toBeGreaterThan(0);
+
+    const missing = testNames.filter(name => !(name in E2E_TOUCHFILES));
+    if (missing.length > 0) {
+      throw new Error(
+        `E2E tests missing TOUCHFILES entries: ${missing.join(', ')}\n` +
+        `Add these to E2E_TOUCHFILES in test/helpers/touchfiles.ts`,
+      );
+    }
+  });
+
+  test('every LLM-judge test has a TOUCHFILES entry', () => {
+    const llmContent = fs.readFileSync(
+      path.join(ROOT, 'test', 'skill-llm-eval.test.ts'),
+      'utf-8',
+    );
+
+    // Extract test names from addTest({ name: '...' }) calls
+    const nameRegex = /name:\s*['"`]([^'"`]+)['"`]/g;
+    const testNames: string[] = [];
+    let match;
+    while ((match = nameRegex.exec(llmContent)) !== null) {
+      testNames.push(match[1]);
+    }
+
+    // Deduplicate (some tests call addTest with the same name)
+    const unique = [...new Set(testNames)];
+    expect(unique.length).toBeGreaterThan(0);
+
+    const missing = unique.filter(name => !(name in LLM_JUDGE_TOUCHFILES));
+    if (missing.length > 0) {
+      throw new Error(
+        `LLM-judge tests missing TOUCHFILES entries: ${missing.join(', ')}\n` +
+        `Add these to LLM_JUDGE_TOUCHFILES in test/helpers/touchfiles.ts`,
+      );
+    }
+  });
+});

package/gstack-origin/unfreeze/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: unfreeze
+version: 0.1.0
+description: |
+  Clear the freeze boundary set by /freeze, allowing edits to all directories
+  again. Use when you want to widen edit scope without ending the session.
+  Use when asked to "unfreeze", "unlock edits", "remove freeze", or
+  "allow all edits".
+allowed-tools:
+  - Bash
+  - Read
+---
+<!-- AUTO-GENERATED from SKILL.md.tmpl — do not edit directly -->
+<!-- Regenerate: bun run gen:skill-docs -->
+
+# /unfreeze — Clear Freeze Boundary
+
+Remove the edit restriction set by `/freeze`, allowing edits to all directories.
+
+```bash
+mkdir -p ~/.gstack/analytics
+echo '{"skill":"unfreeze","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")'"}'  >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
+```
+
+## Clear the boundary
+
+```bash
+STATE_DIR="${CLAUDE_PLUGIN_DATA:-$HOME/.gstack}"
+if [ -f "$STATE_DIR/freeze-dir.txt" ]; then
+  PREV=$(cat "$STATE_DIR/freeze-dir.txt")
+  rm -f "$STATE_DIR/freeze-dir.txt"
+  echo "Freeze boundary cleared (was: $PREV). Edits are now allowed everywhere."
+else
+  echo "No freeze boundary was set."
+fi
+```
+
+Tell the user the result. Note that `/freeze` hooks are still registered for the
+session — they will just allow everything since no state file exists. To re-freeze,
+run `/freeze` again.

package/gstack-origin/unfreeze/SKILL.md.tmpl

@@ -0,0 +1,38 @@
+---
+name: unfreeze
+version: 0.1.0
+description: |
+  Clear the freeze boundary set by /freeze, allowing edits to all directories
+  again. Use when you want to widen edit scope without ending the session.
+  Use when asked to "unfreeze", "unlock edits", "remove freeze", or
+  "allow all edits".
+allowed-tools:
+  - Bash
+  - Read
+---
+
+# /unfreeze — Clear Freeze Boundary
+
+Remove the edit restriction set by `/freeze`, allowing edits to all directories.
+
+```bash
+mkdir -p ~/.gstack/analytics
+echo '{"skill":"unfreeze","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","repo":"'$(basename "$(git rev-parse --show-toplevel 2>/dev/null)" 2>/dev/null || echo "unknown")'"}'  >> ~/.gstack/analytics/skill-usage.jsonl 2>/dev/null || true
+```
+
+## Clear the boundary
+
+```bash
+STATE_DIR="${CLAUDE_PLUGIN_DATA:-$HOME/.gstack}"
+if [ -f "$STATE_DIR/freeze-dir.txt" ]; then
+  PREV=$(cat "$STATE_DIR/freeze-dir.txt")
+  rm -f "$STATE_DIR/freeze-dir.txt"
+  echo "Freeze boundary cleared (was: $PREV). Edits are now allowed everywhere."
+else
+  echo "No freeze boundary was set."
+fi
+```
+
+Tell the user the result. Note that `/freeze` hooks are still registered for the
+session — they will just allow everything since no state file exists. To re-freeze,
+run `/freeze` again.

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@runchr/gstack-antigravity",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Local installer for gStack-Antigravity (.agents layout)",
+  "keywords": [
+    "antigravity",
+    "gstack",
+    "agent",
+    "workflow",
+    "skills"
+  ],
+  "homepage": "https://github.com/runchr-com/gstack-antigravity#readme",
+  "bugs": {
+    "url": "https://github.com/runchr-com/gstack-antigravity/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/runchr-com/gstack-antigravity.git"
+  },
+  "files": [
+    "bin/",
+    "scripts/",
+    ".agents/workflows/",
+    ".agents/rules/",
+    "gstack-origin/",
+    "README.md",
+    "README_KO.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "gstack-antigravity": "bin/install.js"
+  },
+  "license": "MIT"
+}