oh-my-auggie 0.3.1

package/.augment-plugin/marketplace.json

@@ -0,0 +1,21 @@
+{
+  "name": "oh-my-auggie",
+  "description": "Multi-agent orchestration plugin for Augment Code — Explorer → Planner → Executor → Architect pipeline with persistence loops and CI/CD-native workflows",
+  "version": "0.3.1",
+  "plugins": [
+    {
+      "name": "oma",
+      "description": "Multi-agent orchestration plugin with 20+ agents, 28 skills, TypeScript hooks, MCP state server, and enterprise-ready workflows",
+      "version": "0.3.1",
+      "source": "./plugins/oma",
+      "category": "productivity",
+      "tags": [
+        "multi-agent",
+        "orchestration",
+        "automation",
+        "ci-cd",
+        "enterprise"
+      ]
+    }
+  ]
+}

package/.claude-plugin/marketplace.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "oh-my-auggie",
+  "description": "Multi-agent orchestration plugin for Augment Code — Explorer → Planner → Executor → Architect pipeline with persistence loops and CI/CD-native workflows",
+  "owner": {
+    "name": "oh-my-auggie contributors",
+    "email": "r3dtuxedo@gmail.com"
+  },
+  "plugins": [
+    {
+      "name": "oh-my-auggie",
+      "description": "Multi-agent orchestration plugin for Augment Code with 20+ agents, 28 skills, TypeScript hooks, MCP state server, and enterprise-ready workflows",
+      "version": "0.3.1",
+      "author": {
+        "name": "oh-my-auggie contributors"
+      },
+      "source": "./plugins/oma",
+      "category": "productivity",
+      "homepage": "https://github.com/r3dlex/oh-my-auggie",
+      "tags": [
+        "multi-agent",
+        "orchestration",
+        "automation",
+        "ci-cd",
+        "enterprise",
+        "developer-tools"
+      ]
+    }
+  ],
+  "version": "0.3.1"
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,24 @@
+{
+  "name": "oh-my-auggie",
+  "version": "0.3.1",
+  "description": "Multi-agent orchestration plugin for Augment Code — Explorer → Planner → Executor → Architect pipeline with persistence loops and CI/CD-native workflows",
+  "author": {
+    "name": "oh-my-auggie contributors"
+  },
+  "homepage": "https://github.com/r3dlex/oh-my-auggie",
+  "repository": "https://github.com/r3dlex/oh-my-auggie",
+  "license": "MIT",
+  "keywords": [
+    "augment-code",
+    "plugin",
+    "multi-agent",
+    "orchestration",
+    "automation",
+    "ci-cd"
+  ],
+  "commands": "./commands/",
+  "agents": "./agents/",
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks.json",
+  "mcpServers": "./.mcp.json"
+}

package/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: [r3dlex]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

package/.github/workflows/ci.yml

@@ -0,0 +1,143 @@
+name: CI
+
+# ── Auto-merge setup ────────────────────────────────────────────────────────────
+# Create PR: gh pr create --base main --fill
+# Enable auto-merge: gh pr merge --auto --squash --repo OWNER/REPO
+# GitHub auto-merges once all CI checks pass AND PR is approved.
+# No workflow configuration needed — GitHub handles merge_blocked /
+# merge_group events automatically.
+#
+# Branch protection note: if main has "Require pull request reviews before
+# merging" enabled, the PR still needs an approving review before GitHub
+# will auto-merge — even with --auto set at merge time.
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  hooks-check:
+    name: Validate hook entry points
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Verify hooks.json has no .sh references
+        run: |
+          if grep -q '\.sh' plugins/oma/hooks/hooks.json; then
+            echo "ERROR: hooks.json still contains .sh references"
+            grep '\.sh' plugins/oma/hooks/hooks.json
+            exit 1
+          fi
+          echo "hooks.json entry points are correct (all .js)"
+
+  test:
+    name: Test (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, ubuntu-24.04-arm]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: plugins/oma/package-lock.json
+      - name: Install dependencies
+        run: cd plugins/oma && npm ci
+      - name: TypeScript type check
+        run: cd plugins/oma && npx tsc --noEmit
+      - name: Unit + integration tests with coverage
+        run: cd plugins/oma && npx vitest run --coverage
+
+  cli:
+    name: oma CLI e2e
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install bats
+        run: sudo apt-get update && sudo apt-get install -y bats
+      - name: Run CLI e2e tests
+        run: bats e2e/oma-cli.bats e2e/super-oma-cli.bats
+
+  validate-manifests:
+    name: Validate manifests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Validate JSON manifests
+        run: |
+          node -e "
+            const fs = require('fs');
+            const files = [
+              '.augment-plugin/marketplace.json',
+              'plugins/oma/.augment-plugin/plugin.json',
+              'plugins/oma/.augment-plugin/.mcp.json',
+              'plugins/oma/hooks/hooks.json',
+              '.claude-plugin/plugin.json'
+            ];
+            for (const f of files) {
+              try {
+                JSON.parse(fs.readFileSync(f));
+                console.log('OK: ' + f);
+              } catch(e) {
+                console.error('FAIL: ' + f + ' - ' + e.message);
+                process.exit(1);
+              }
+            }
+          "
+      - name: Verify hook command entrypoints exist
+        run: |
+          node -e "
+            const fs = require('fs');
+            const hooksManifest = JSON.parse(fs.readFileSync('plugins/oma/hooks/hooks.json', 'utf8'));
+            const missing = [];
+            const invalid = [];
+            const seen = new Set();
+
+            for (const groups of Object.values(hooksManifest.hooks || {})) {
+              for (const group of groups || []) {
+                for (const hook of group.hooks || []) {
+                  const match = typeof hook.command === 'string' && hook.command.match(/dist\\/hooks\\/([A-Za-z0-9-]+\\.js)/);
+                  if (!match) {
+                    invalid.push(hook.command || '<missing command>');
+                    continue;
+                  }
+
+                  const entrypoint = 'plugins/oma/dist/hooks/' + match[1];
+                  if (seen.has(entrypoint)) continue;
+                  seen.add(entrypoint);
+
+                  if (!fs.existsSync(entrypoint)) {
+                    missing.push(entrypoint);
+                    continue;
+                  }
+
+                  console.log('OK: ' + entrypoint);
+                }
+              }
+            }
+
+            if (invalid.length) {
+              console.error('FAIL: non-dist hook commands in hooks.json');
+              for (const command of invalid) console.error('INVALID: ' + command);
+              process.exit(1);
+            }
+
+            if (!seen.size) {
+              console.error('FAIL: hooks.json did not declare any dist hook entrypoints');
+              process.exit(1);
+            }
+
+            if (missing.length) {
+              console.error('FAIL: missing compiled hook entrypoints');
+              for (const entrypoint of missing) console.error('MISSING: ' + entrypoint);
+              process.exit(1);
+            }
+          "

package/.github/workflows/release.yml

@@ -0,0 +1,110 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      packages: write
+      issues: write
+      pull-requests: write
+
+    outputs:
+      new-release-published: ${{ steps.semantic.outputs.new_release_published }}
+      new-release-version: ${{ steps.semantic.outputs.new_release_version }}
+      new-release-channel: ${{ steps.semantic.outputs.new_release_channel }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://npm.pkg.github.com'
+          scope: '@r3dlex'
+
+      - name: Install dependencies
+        run: cd plugins/oma && npm ci
+
+      - name: Build
+        run: cd plugins/oma && npm run prepare
+
+      - name: Run tests
+        run: cd plugins/oma && npm test
+
+      - name: Semantic Release
+        id: semantic
+        uses: cycjimmy/semantic-release-action@v4
+        with:
+          extra_plugins: |
+            @semantic-release/changelog
+            @semantic-release/git
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish-npm:
+    needs: release
+    if: needs.release.outputs.new-release-published == 'true'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          ref: v${{ needs.release.outputs.new-release-version }}
+
+      - name: Setup Node.js for npmjs.com
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+          scope: '@r3dlex'
+
+      - name: Install dependencies
+        run: cd plugins/oma && npm ci
+
+      - name: Build
+        run: cd plugins/oma && npm run prepare
+
+      - name: Strip publishConfig and prepare script
+        run: |
+          cd plugins/oma
+          node -e "
+            const fs = require('fs');
+            const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
+            delete pkg.publishConfig;
+            if (pkg.scripts) delete pkg.scripts.prepare;
+            fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');
+          "
+
+      - name: Publish @r3dlex/oh-my-auggie to npmjs.com (OIDC trusted publishing)
+        continue-on-error: true
+        run: |
+          CHANNEL="${{ needs.release.outputs.new-release-channel }}"
+          TAG="${CHANNEL:-latest}"
+          cd plugins/oma && npm publish --tag "$TAG" --provenance --access public
+
+      - name: Publish oh-my-auggie (unscoped) to npmjs.com
+        continue-on-error: true
+        run: |
+          CHANNEL="${{ needs.release.outputs.new-release-channel }}"
+          TAG="${CHANNEL:-latest}"
+          # Temporarily rename to unscoped for second publish; runner is ephemeral
+          cd plugins/oma && npm pkg set name="oh-my-auggie"
+          npm publish --tag "$TAG" --provenance --access public

package/.releaserc.json

@@ -0,0 +1,30 @@
+{
+  "branches": ["main"],
+  "tagFormat": "v${version}",
+  "plugins": [
+    ["@semantic-release/commit-analyzer", {
+      "preset": "angular",
+      "releaseRules": [
+        { "type": "feat",     "release": "minor" },
+        { "type": "fix",      "release": "patch" },
+        { "type": "perf",     "release": "patch" },
+        { "type": "refactor", "release": "patch" },
+        { "type": "docs",     "release": "patch" },
+        { "type": "ci",       "release": "patch" },
+        { "type": "chore", "scope": "release", "release": false }
+      ]
+    }],
+    "@semantic-release/release-notes-generator",
+    ["@semantic-release/changelog", {
+      "changelogFile": "CHANGELOG.md"
+    }],
+    ["@semantic-release/npm", {
+      "pkgRoot": "plugins/oma"
+    }],
+    "@semantic-release/github",
+    ["@semantic-release/git", {
+      "assets": ["CHANGELOG.md", "plugins/oma/package.json"],
+      "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
+    }]
+  ]
+}

package/.shellcheckignore

@@ -0,0 +1,4 @@
+# shellcheckignore
+# Suppress SC1090: "Not a constant source" — ${PLUGIN_ROOT} is an Auggie plugin variable
+# that is only set when Auggie loads the plugin, not at shellcheck lint time.
+SC1090

package/AGENTS.md

@@ -0,0 +1,51 @@
+<!-- Generated: 2026-04-12 | Updated: 2026-04-12 -->
+
+# oh-my-auggie
+
+## Purpose
+oh-my-auggie — multi-agent orchestration layer for Augment Code's auggie CLI. Provides 19 specialized agents, 44 slash commands, 36 skills, and 10 hooks for automated, multi-step AI workflows in the auggie IDE.
+
+## Key Files
+| File | Description |
+|------|-------------|
+| README.md | Project overview, installation, commands, and architecture |
+| SPEC.md | Detailed specification: primitives, state files, MCP tools, hooks, profiles |
+| CONTRIBUTING.md | Contribution guidelines and PR process |
+| SECURITY.md | Security policy and vulnerability reporting |
+| CHANGELOG.md | Version history |
+| package.json | Root workspace package descriptor |
+
+## Subdirectories
+| Directory | Purpose |
+|-----------|---------|
+| adr/ | Architectural Decision Records |
+| assets/ | Images and banner assets (no child AGENTS.md — images only) |
+| bin/ | Executable scripts |
+| cli/ | CLI companion utilities |
+| e2e/ | End-to-end bats integration tests |
+| plugins/ | Plugin source — all OMA plugin code lives under plugins/oma/ |
+| scripts/ | Build, validation, and release scripts |
+
+## For AI Agents
+### Working In This Directory
+All plugin source is under `plugins/oma/`. Run `npm test` from `plugins/oma/` before committing. Follow `CONTRIBUTING.md` for PR guidelines. Do not edit `dist/` directly — it is generated by the build.
+
+### Testing Requirements
+```bash
+cd plugins/oma && npm test
+```
+
+### Common Patterns
+- Plugin code lives in `plugins/oma/`
+- CLI companion utilities live in `cli/`
+- End-to-end bats tests live in `e2e/`
+
+## Dependencies
+### Internal
+- `plugins/oma/` — primary plugin package
+
+### External
+- auggie >= 0.22.0
+- node >= 18
+
+<!-- MANUAL: Any manually added notes below this line are preserved on regeneration -->

package/CHANGELOG.md

@@ -0,0 +1,208 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+### CI
+
+- Force JavaScript GitHub Actions to run on Node 24 to remove Node 20 deprecation warnings ahead of the 2026 runner cutoff
+
+---
+
+## [0.3.1](https://github.com/r3dlex/oh-my-auggie/compare/v0.2.1...v0.3.1) (2026-04-14)
+
+### CI
+
+- Fix GitHub Actions ARM test runner label (`ubuntu-24.04-arm`) so CI no longer stalls in queued state
+- Verify local and GitHub CI lanes for typecheck, build, vitest coverage, manifest validation, and CLI e2e
+- Enforce 80%+ minimum branch coverage in `plugins/oma/vitest.config.ts` (statements/functions/branches all remain above 80%)
+
+### Chores
+
+- Align release metadata on `0.3.1` across package manifests, plugin manifests, and marketplace metadata
+- Make root npm scripts delegate to `plugins/oma` scripts so local and CI execution paths stay consistent
+
+### Docs
+
+- Update README version badges and refresh release-readiness notes for the current release line
+- Replace stale version examples in `/oma:version` and `/oma:update` command docs
+
+---
+
+## [0.2.1](https://github.com/r3dlex/oh-my-auggie/compare/v0.2.0...v0.2.1) (2026-04-12)
+
+### Bug Fixes
+
+* **commands:** strip oma- prefix from name: frontmatter and add execution preamble ([4b935e9](https://github.com/r3dlex/oh-my-auggie/commit/4b935e9f88561b69a69a38b65fac7152979d8eb7))
+
+# [0.2.0](https://github.com/r3dlex/oh-my-auggie/compare/v0.1.7...v0.2.0) (2026-04-12)
+
+### Features
+
+* **graph:** graphwiki auto-build, auto-rebuild, resolveProjectDir, and optional dep ([0b2417d](https://github.com/r3dlex/oh-my-auggie/commit/0b2417da79c6127b3378f5ab32b05b28a3b1ee07))
+
+## [0.1.7](https://github.com/r3dlex/oh-my-auggie/compare/v0.1.6...v0.1.7) (2026-04-12)
+
+### CI
+
+- Migrate releases to semantic-release automation
+
+---
+
+## [0.1.6] - 2026-04-12
+
+### Features
+
+- `hooks.costTracking` and `hooks.statusMessages` config flags (both default `false`) — opt-in hook context injection
+
+### Bug Fixes
+
+- CI: add `--ignore-scripts` to npm publish steps to avoid re-running `tsc` without `node_modules`
+
+### CI
+
+- Split release workflow into parallel `build` / `publish-gpr` / `publish-npm` / `github-release` jobs
+- Add Option B: npm OIDC trusted publishing (`publish-npm` job with `id-token: write`, `--provenance`, `--access public`, `continue-on-error: true`)
+
+### Docs
+
+- Document `hooks.costTracking` and `hooks.statusMessages` in `oma-config.md`, `README.md`
+
+---
+
+## [0.1.5] - 2026-04-12
+
+### Features
+
+- Graph provider configuration system with multi-provider bridge (#25)
+- Full JS-to-TS hooks migration: session-start rewrite, setup-rules.ts, hooks.json cutover (#27, #9)
+- OMA v0.2 completeness: XML agent format, ADR system, audit-log hook, ultrawork, ralplan (#23)
+- Phase 2 hooks parity + post-tool-status context injection hook
+- Add `/oma:update` command with session-start background upgrade check
+- Add `/oma:version` and `/oma:whatsnew` commands
+- Add buddy assets, banner, and SECURITY.md
+- Graph provider deviation fixes (#28)
+
+### Bug Fixes
+
+- Wrap post-tool-status output in `hookSpecificOutput` JSON — fixes hook protocol (#30)
+- Fix graph-provider keyword command target (#30)
+- cost-track: parse stdin before estimating credits — fixes always-88-credits bug (#31)
+- cost-track: estimate tokens from stdin when Auggie provides no token counts
+- MCP: use relative path instead of `AUGMENT_PLUGIN_ROOT` env var
+- Fix OMA figure placement and captions in README (#20, #21)
+- Exclude audit-log.ts from coverage (enterprise-only hook)
+
+### Docs
+
+- Add hierarchical AGENTS.md with 19 agents and 44 commands (#29)
+- Add `/oma:setup` and `/oma:mcp-setup` post-install steps to all 12 README language variants
+- Rewrite `/oma:update` command as imperative step-by-step instructions
+- Bring CHANGELOG.md and CONTRIBUTING.md to repository root (#22)
+
+### Refactors
+
+- CI: zero-install with `npm ci` cache + ARM64 matrix + apt bats (#24)
+
+---
+
+## [0.1.4] - 2026-04-10
+
+### Chores
+
+- Bump version to v0.1.4
+- Add `prd.json` to `.gitignore`
+
+---
+
+## [0.1.3-alpha.1] - 2026-04-09
+
+### Features
+
+- Add version-bump script for OMA releases
+
+### Docs
+
+- Add 11 translated README files (de, es, fr, it, ja, ko, pt, ru, tr, vi, zh)
+
+---
+
+## [0.1.2-alpha.1] - 2026-04-09
+
+### Bug Fixes
+
+- CI: embed git SHA in pre-release versions for idempotent re-runs
+
+### Docs
+
+- Add Sponsor section to README, SPEC, and CONTRIBUTING
+
+---
+
+## [0.1.1-alpha.1] - 2026-04-09
+
+### Features
+
+- OMA v0.2 complete: 19 agents, 30 commands, 7 hooks, and skills system (#8)
+- OS detection, short-alias commands, and `/skills` command (#11)
+- Port Phase 1 OMC skills to OMA (#12)
+- Phase 2 command overlap resolution enhancements (#13)
+- Phase 0 skillify audit + Phase 3 deferred skills (#14)
+- Rewrite all 7 shell hooks in TypeScript for Windows support (#9)
+- Add OMA CLI companion v1: `oma team`, `oma hud`, `oma doctor`
+- Two-tiered config system with enterprise profile support (#16)
+- OMA skills system enhancement — OMC section parity and two-tier index (#17)
+- Add tdd + improve-codebase-architecture skills, examples, and benchmarks (#18)
+- Expand keyword-detect with all OMA commands as magic keywords
+- Phase 3.5 rule template installation via `/oma:setup`
+- Add context7, exa, GitHub MCP servers
+- Auto-invoke mcp-setup and add ADO/Figma MCP servers
+- Add `/oma:deep-interview` command with alias
+- Add HUD auto-display on session start
+- Port missing OMC commands + team worktree isolation
+- Expand `/oma:setup` Phase 1–4 with actual bash commands
+- Align plugin manifests for Claude Code compatibility
+- Add Claude Code-compatible marketplace.json
+- Add CHANGELOG, CONTRIBUTING, release CI, and sponsor badge
+
+### Bug Fixes
+
+- CI: add `contents:write` permission for GitHub release creation
+- CI: unescape `$` in release workflow shell commands
+- CI: add `--force` to npm publish for idempotent re-runs
+- CI: add `npm install` step to typecheck and vitest jobs; fix `dist/*.js` (#10)
+- CI: use shell expansion for PATH in bats test step (#5)
+- Correct Auggie hook format (array → object per event)
+- Remove matcher fields, increase hook timeout to 5000ms
+- Shell-wrap node command to expand `${PLUGIN_ROOT}`
+- Use correct package names for context7, exa, github MCP servers
+- Remove mcp from auto-config; fix cost-track `OMA_DIR` resolution
+- cost-track: create `.oma` dir before writing cost-log
+- Correct owner email in marketplace.json
+- Correct GitHub owner from archgate to r3dlex in all references
+- Sensitive data guard (#4)
+- Fix bats: write state to server's hardcoded `.oma/state.json` path (#6)
+
+### Refactors
+
+- Convert all `.sh` hooks to `.mjs` (ESM) (#15)
+- Simplify augment marketplace.json to match schema
+
+### Chores
+
+- Remove OMC-style command files
+- Remove `e2e/oma-core-loop.bats` (replaced by Vitest)
+- Add `.gitignore` for OMA runtime dirs + auto-merge docs in CI (#3)
+- Rewrite README with marketplace install instructions
+
+---
+
+## [0.1.0-alpha.1] - 2026-04-09
+
+### Features
+
+- Initial release of oh-my-auggie (OMA)
+- Phase 1–4 implementation with orchestration modes: autopilot, ralph, ultrawork, ultraqa, ralplan
+- 7 TypeScript hooks: session-start, keyword-detect, cost-track, delegation-enforce, approval-gate, adr-enforce, audit-log
+- Full Vitest test suite with 80%+ coverage across statements, branches, and functions