@djordje-stojanovic/sigmaskills 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,32 @@ All notable changes to [Sigmaskills](https://github.com/Djordje-Stojanovic/Sigma
 
 ## [Unreleased]
 
+## [0.3.0] — 2026-09-08
+
+### Added
+
+- SigmaRefactor (`sigmarefactor`) scans and reconciles the five largest maintained files, reads them fully, discusses behavior-preserving refactoring choices with the user, and verifies approved changes.
+
+### Fixed
+
+- The interactive installer stops repeating unchanged static pages and pauses standard input during cleanup, so confirmed installs return to the shell reliably.
+- The installer opens directly to skill selection, keeps destination pages within eight rows, and offers line-based commands in plain terminals. Help preserves cancellation, and short terminals keep focus and controls visible.
+- Package tests compare complete trees and bytes for all five skills, including customized reinstall protection and updates.
+
+
+## [0.2.1] — 2026-08-27
+
+### Changed
+
+- The Agent Host registry now includes Posit Assistant from the pinned `vercel-labs/skills` revision `dd3ca3c85581`.
+
+### Fixed
+
+- The destination picker paints one compact row per path, windows a live TTY list, groups search hits that share a path, and leaves the alternate screen before cancel or error copy so Windows does not stack or swallow that text.
+- Registry Sync no longer fails when a leftover `registry/sync-*` branch still exists: it replaces that generated branch, or reuses a matching open pull request, and still refuses human branches.
+- Release packing reads `npm pack --json` after prepack logs, so publication can rebuild the tarball digest.
+
+
 ## [0.2.0] — 2026-08-20
 
 ### Fixed
@@ -72,6 +98,7 @@ Ship high-rigor, installable agent skills (not apps): full-repo audits, performa
 | 2026-08-11 | `5dab832` | Add CHANGELOG and mark v0.1.0 as the first Sigmaskills release |
 | 2026-08-11 | `124a666` | Polish v0.1.0 docs for multi-host install and use |
 
-[Unreleased]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.2.0...HEAD
+[Unreleased]: https://github.com/Djordje-Stojanovic/Sigmaskills/compare/v0.2.1...HEAD
+[0.2.1]: https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.2.1
 [0.2.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.2.0
 [0.1.0]: https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.1.0

package/README.md

@@ -6,7 +6,7 @@ Portable [Agent Skills](https://agentskills.io/) that install once and run on **
 
 | | |
 |---|---|
-| **Release** | [**v0.2.0**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.2.0) |
+| **Release** | [**v0.3.0**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.3.0) |
 | **Changelog** | [CHANGELOG.md](CHANGELOG.md) |
 | **License** | [MIT](LICENSE) |
 | **Spec** | [agentskills.io](https://agentskills.io/) |
@@ -16,6 +16,7 @@ Portable [Agent Skills](https://agentskills.io/) that install once and run on **
   Σ  performance→  calibrated bottlenecks, one report PR
   Σ  brief      →  paste-ready agent briefs, chat only
   Σ  write      →  clear STE-inspired technical English
+  Σ  refactor   →  user-guided, behavior-preserving code reduction
 ```
 
 ---
@@ -50,6 +51,7 @@ Then invoke with your host’s normal skill syntax (`$sigmawrite`, `/skill:sigma
 | **SigmaPerformance** | `sigmaperformance` | Calibrated performance investigation | One report MD + report-only PR |
 | **SigmaBrief** | `sigmabrief` | Prompt factory for parallel / single agents | Chat briefs only |
 | **SigmaWrite** | `sigmawrite` | Clear STE-inspired technical English | Chat writing voice |
+| **SigmaRefactor** | `sigmarefactor` | Safe, user-approved large-file refactoring | Discussion, changes, and verification |
 
 ### SigmaReview
 
@@ -69,15 +71,21 @@ Turns GitHub issues, features, upgrades, bugs, or plain work statements into sho
 
 Writing voice inspired by **ASD-STE100 Simplified Technical English** — soft steers, not hard numbered rules. High-quality, still-technical explanations a sharp outsider can follow. Hard bans on gibberish and invented words. Includes a pasteable system-prompt block inside `SKILL.md`. Not certified STE; no dictionary ship.
 
+### SigmaRefactor
+
+Runs a reproducible `laloc` scan, reads the five largest maintained files, explains safe refactoring choices, and waits for user agreement before editing. It checks directories that `laloc` skips, preserves behavior and user changes, and reports lines removed separately from lines moved into new modules.
+
 ---
 
 ## Install
 
 ### Sigma Installer: Project Installation (recommended)
 
-Run `npx @djordje-stojanovic/sigmaskills` with no command. The Sigma Installer's Emberforge interface reads the Skill Pack catalog from `manifest.json` and the bundled Agent Host registry. Project Installation selects only the universal `.agents/skills/` destination by default, expands every Agent Host that reads it, and leaves host-specific destinations unselected until you choose them. Search remains available for every supported Agent Host, including hosts that are not detected. Exact current official copies and valid links are recorded as managed without rewriting skill bytes. Escape, EOF, Ctrl+C, or a rejected confirmation exits without writing.
+Run `npx @djordje-stojanovic/sigmaskills` with no command. The Sigma Installer's Emberforge interface reads the Skill Pack catalog from `manifest.json` and the bundled Agent Host registry. Project Installation selects only the universal `.agents/skills/` destination by default, shows a compact host-path list, and leaves host-specific destinations unselected until you choose them. Search remains available for every supported Agent Host, including hosts that are not detected. Exact current official copies and valid links are recorded as managed without rewriting skill bytes. Escape, EOF, Ctrl+C, or a rejected confirmation exits without writing.
+
+The installer opens directly to a small Sigma heading in the warm LAPI palette. Skill descriptions stay in a bounded focus area. Destination pages show at most eight rows and adapt to terminal height. Long confirmation paths wrap onto pages; use `next`/`prev` in plain mode or left/right arrows in interactive mode. Reduced motion keeps the same picker: there is no opening animation. The cursor, raw mode, input flow, and listeners are restored when the installer finishes or stops.
 
-The Emberforge screens keep the accepted warm LAPI palette and do not mix in Prismgrid or Monolith. Layouts reflow below 76 columns and wrap long paths. Keyboard-only controls cover focus, search, selection, confirmation, cancellation, and `?` help. `--no-color`, `--static`, `--narrow`, `--json`, `NO_COLOR`, `CI`, `REDUCED_MOTION=1`, `PREFERS_REDUCED_MOTION=reduce`, redirected output, and non-TTY sessions disable animation and decorative color. Truecolor, 256-color, 16-color, and ASCII fallbacks stay readable and still show safety copy. The cursor and raw mode restore after success, failure, interrupt, EOF, and exceptions.
+With `--static`, `--no-color`, `NO_COLOR`, `CI`, redirected output, or a non-TTY session, enter one command per line. Type a row number to toggle it, `/claude` to search destinations, `/` to clear search, `next` or `prev` to change page, and press Enter to continue. Use `a` to select all skills, `g` for the global warning, `?` for help, or `esc` to cancel. Confirm installation with `y` followed by Enter. Only `.agents/skills` is selected by default; detected hosts stay unselected.
 
 Use `--no-color`, `--static`, or `--narrow` when the terminal needs those modes. Use `--project <path>` to select another project root.
 
@@ -109,7 +117,7 @@ Non-interactive mutation requires both `--global` and `--yes`. `--dry-run` shows
 
 ### Sigma Installer: Agent Host registry automation
 
-The `registry-sync.yml` workflow fetches one pinned `vercel-labs/skills` revision as data and runs converter code only from the exact default-branch SHA in `EXPECTED_HEAD`. Generated changes are limited to `registry/agent-hosts.json`, `registry/source.json`, and `test/fixtures/vercel-skills/src/agents.ts`. New hosts must pass safe-root, traversal, collision, overlap, control-character, and platform checks. Only a generated pull request from that trusted workflow, with an exact allowlisted diff, the validated head SHA, current protected `main`, and all required checks may auto-merge. Validated additions and description-only edits can then publish a patch Release through the same idempotent trusted publication primitive as owner Releases. Path, ID, alias, detection, platform, membership, removal, unknown fields, and validation failures stay blocked for owner review. Version calculation serializes concurrent runs and reconciles npm and GitHub before the patch. The generated branch is deleted only after verified merge and matching npm/GitHub completion. Automation cannot change skills, CLI behavior, unrelated issues or pull requests, human branches, or major/minor Releases, and it never overwrites an existing npm version. Configure an npm trusted publisher for `registry-sync.yml` in addition to `release.yml`.
+The `registry-sync.yml` workflow fetches one pinned `vercel-labs/skills` revision as data and runs converter code only from the exact default-branch SHA in `EXPECTED_HEAD`. Generated changes are limited to `registry/agent-hosts.json`, `registry/source.json`, and `test/fixtures/vercel-skills/src/agents.ts`. New hosts must pass safe-root, traversal, collision, overlap, control-character, and platform checks. Only a generated pull request from that trusted workflow, with an exact allowlisted diff, the validated head SHA, current protected `main`, and all required checks may auto-merge. Validated additions and description-only edits can then publish a patch Release through the same idempotent trusted publication primitive as owner Releases. Path, ID, alias, detection, platform, membership, removal, unknown fields, and validation failures stay blocked for owner review. Version calculation serializes concurrent runs and reconciles npm and GitHub before the patch. The generated branch is deleted only after verified merge and matching npm/GitHub completion. If that generated branch is leftover from an earlier run, Generate replaces it; if a matching generated pull request is already open, Generate reuses it instead of failing the push. Automation cannot change skills, CLI behavior, unrelated issues or pull requests, human branches, or major/minor Releases, and it never overwrites an existing npm version. Configure an npm trusted publisher for `registry-sync.yml` in addition to `release.yml`.
 
 ### Sigma Installer: release
 
@@ -128,6 +136,7 @@ npx skills add Djordje-Stojanovic/Sigmaskills --skill sigmareview -g
 npx skills add Djordje-Stojanovic/Sigmaskills --skill sigmaperformance -g
 npx skills add Djordje-Stojanovic/Sigmaskills --skill sigmabrief -g
 npx skills add Djordje-Stojanovic/Sigmaskills --skill sigmawrite -g
+npx skills add Djordje-Stojanovic/Sigmaskills --skill sigmarefactor -g
 
 # Pin to specific hosts
 npx skills add Djordje-Stojanovic/Sigmaskills --skill sigmawrite -g -a cursor -a claude-code -a codex -a opencode -a pi
@@ -149,6 +158,7 @@ $skill-installer install sigmareview from https://github.com/Djordje-Stojanovic/
 $skill-installer install sigmaperformance from https://github.com/Djordje-Stojanovic/Sigmaskills
 $skill-installer install sigmabrief from https://github.com/Djordje-Stojanovic/Sigmaskills
 $skill-installer install sigmawrite from https://github.com/Djordje-Stojanovic/Sigmaskills
+$skill-installer install sigmarefactor from https://github.com/Djordje-Stojanovic/Sigmaskills
 ```
 
 ### Manual / universal copy
@@ -164,6 +174,7 @@ cp -R Sigmaskills/sigmareview ~/.agents/skills/sigmareview
 cp -R Sigmaskills/sigmaperformance ~/.agents/skills/sigmaperformance
 cp -R Sigmaskills/sigmabrief ~/.agents/skills/sigmabrief
 cp -R Sigmaskills/sigmawrite ~/.agents/skills/sigmawrite
+cp -R Sigmaskills/sigmarefactor ~/.agents/skills/sigmarefactor
 ```
 
 **Windows (PowerShell)**
@@ -175,6 +186,7 @@ Copy-Item -Recurse Sigmaskills\sigmareview   "$HOME\.agents\skills\sigmareview"
 Copy-Item -Recurse Sigmaskills\sigmaperformance "$HOME\.agents\skills\sigmaperformance"
 Copy-Item -Recurse Sigmaskills\sigmabrief    "$HOME\.agents\skills\sigmabrief"
 Copy-Item -Recurse Sigmaskills\sigmawrite    "$HOME\.agents\skills\sigmawrite"
+Copy-Item -Recurse Sigmaskills\sigmarefactor "$HOME\.agents\skills\sigmarefactor"
 ```
 
 Point other hosts at the same folders (or copy again) as needed:
@@ -188,7 +200,7 @@ Point other hosts at the same folders (or copy again) as needed:
 | OpenCode | `~/.config/opencode/skills/<id>/` |
 | Codex | `~/.codex/skills/<id>/` |
 
-Release zip: download [**Sigmaskills-v0.2.0**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.2.0) and copy the four skill folders into the path your agent reads.
+Release zip: [**Sigmaskills-v0.2.1**](https://github.com/Djordje-Stojanovic/Sigmaskills/releases/tag/v0.2.1) contains the four skills released at that version. SigmaRefactor and the revised installer are available from the current repository source until a new package release is published.
 
 ### Optional: SigmaWrite as system prompt
 
@@ -212,6 +224,7 @@ $sigmaperformance https://github.com/owner/repo
 $sigmabrief https://github.com/owner/repo/issues/12
 $sigmabrief all open
 $sigmawrite
+$sigmarefactor
 ```
 
 </td>
@@ -225,6 +238,7 @@ $sigmawrite
 /skill:sigmabrief https://github.com/owner/repo/issues/12
 /skill:sigmabrief all open
 /skill:sigmawrite
+/skill:sigmarefactor
 ```
 
 </td>
@@ -240,6 +254,7 @@ Use the skill picker, `@` / `$` skill mention, or whatever that product document
 | `sigmaperformance` | repo URL | Starts with two short calibration batches, then runs |
 | `sigmabrief` | issue URL · `#N` · `all open` · plain work | Explicit only — not ambient |
 | `sigmawrite` | (no args) | Session writing voice until you turn it off |
+| `sigmarefactor` | repository path or current repository | Scans and discusses large files before any edit |
 
 ---
 
@@ -280,6 +295,13 @@ Use the skill picker, `@` / `$` skill mention, or whatever that product document
 - Optional pasteable system-prompt block in `SKILL.md`
 - Does not override another skill’s rigid output contract
 
+### SigmaRefactor
+
+- Five-stage scan → read → discussion → implementation → verification flow
+- `laloc` reconciliation with a maintained-file inventory and explicit exclusions
+- User approval before edits; behavior, tests, interfaces, and custom content stay protected
+- Final line-count comparison with removed and moved lines reported separately
+
 ---
 
 ## Requirements
@@ -291,6 +313,7 @@ Use the skill picker, `@` / `$` skill mention, or whatever that product document
 | SigmaPerformance | Authority / safety boundary chosen in calibration |
 | SigmaBrief | `gh` read when briefing from issues/PRs · **no** push to the product repo |
 | SigmaWrite | Nothing beyond chat — optional paste into system instructions |
+| SigmaRefactor | Read access to the target repository and `laloc` when available; no required external skill |
 
 Windows-native defaults where skills mention shells or worktrees (PowerShell-friendly; do not assume WSL).
 
@@ -307,7 +330,8 @@ Sigmaskills/
 ├── sigmareview/              SKILL.md · agents/ · references/
 ├── sigmaperformance/         SKILL.md · agents/ · references/
 ├── sigmabrief/               SKILL.md · agents/ · references/
-└── sigmawrite/               SKILL.md · agents/
+├── sigmawrite/               SKILL.md · agents/
+└── sigmarefactor/            SKILL.md · agents/ · references/
 ```
 
 Each top-level folder is one installable skill. `name` in frontmatter = folder name = `--skill` id.

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "name": "sigmaskills",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Portable Agent Skills monorepo and first-party Sigma Installer",
   "skills": [
     {
@@ -23,6 +23,11 @@
       "id": "sigmawrite",
       "title": "SigmaWrite",
       "needsReferences": false
+    },
+    {
+      "id": "sigmarefactor",
+      "title": "SigmaRefactor",
+      "needsReferences": true
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djordje-stojanovic/sigmaskills",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Portable Agent Skills monorepo and first-party Sigma Installer",
   "type": "module",
   "bin": {
@@ -18,6 +18,7 @@
     "sigmaperformance",
     "sigmabrief",
     "sigmawrite",
+    "sigmarefactor",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"