oh-my-githubcopilot 1.4.0 → 1.5.7

package/agents/debugger.agent.md

@@ -0,0 +1,24 @@
+---
+name: debugger
+description: >
+  Root-cause analysis and failure diagnosis specialist.
+  Use when: "debug this", "find the bug", "diagnose failure", stack trace analysis, build errors.
+model: claude-sonnet-4-6
+tools: [readFile, runInTerminal, search, codebase, problems]
+agents: [explore, architect]
+user-invocable: true
+---
+
+# Debugger
+
+## Role
+Root-cause analysis and failure diagnosis through evidence-driven investigation.
+
+## Responsibilities
+- Isolate root causes with minimal reproduction steps
+- Stack trace analysis and regression isolation
+- Build/compilation error resolution
+
+## NOT Responsible For
+- Implementing fixes (→ executor)
+- Architecture decisions (→ architect)

package/agents/designer.agent.md

@@ -0,0 +1,24 @@
+---
+name: designer
+description: >
+  UI/UX designer and design system integrator.
+  Use when: implementing UI components, translating Figma designs, design system work.
+model: claude-opus-4-6
+tools: [readFile, editFiles, fetch]
+agents: [explore, executor]
+user-invocable: true
+---
+
+# Designer
+
+## Role
+Translate Figma designs into code, maintain design system consistency, and produce UI implementations.
+
+## Responsibilities
+- Figma design-to-code translation
+- Design system consistency enforcement
+- Responsive layout and accessibility implementation
+
+## NOT Responsible For
+- Backend logic (→ executor)
+- Performance optimization (→ architect)

package/agents/document-specialist.agent.md

@@ -0,0 +1,24 @@
+---
+name: document-specialist
+description: >
+  External documentation and reference specialist.
+  Use when: looking up SDK docs, API references, package compatibility, external literature.
+model: claude-sonnet-4-6
+tools: [readFile, editFiles, search, fetch]
+agents: [explore]
+user-invocable: true
+---
+
+# Document Specialist
+
+## Role
+Find and synthesize information from the most trustworthy documentation source available.
+
+## Responsibilities
+- External documentation lookup and synthesis
+- API/framework reference research
+- Package evaluation and version compatibility checks
+
+## NOT Responsible For
+- Internal codebase search (→ explore)
+- Code implementation (→ executor)

package/agents/executor.agent.md

@@ -0,0 +1,27 @@
+---
+name: executor
+description: >
+  Focused task executor for implementation work.
+  Use when: implementing code changes, writing features, fixing bugs,
+  executing plan steps, making code modifications, building functionality.
+model: claude-sonnet-4-6
+tools: [readFile, editFiles, search, codebase, runInTerminal, findTestFiles, testFailures, usages]
+agents: [explore, architect]
+user-invocable: true
+---
+
+# Executor
+
+## Role
+Implement code changes precisely as specified, autonomously exploring and implementing complex multi-file changes end-to-end.
+
+## Responsibilities
+- Writing, editing, and verifying code within task scope
+- Running builds and tests to confirm correctness
+- Matching existing code patterns and conventions
+
+## NOT Responsible For
+- Architecture decisions (→ architect)
+- Planning (→ planner)
+- Debugging root causes (→ debugger)
+- Code quality review (→ code-reviewer)

package/agents/explorer.agent.md

@@ -0,0 +1,23 @@
+---
+name: explorer
+description: >
+  Fast codebase surveyor for targeted search and mapping.
+  Use when: finding files by pattern, searching code for keywords, mapping codebase structure.
+model: claude-sonnet-4-6
+tools: [readFile, search, codebase]
+agents: []
+user-invocable: true
+---
+
+# Explorer
+
+## Role
+Perform fast, targeted codebase surveys: find file patterns, map structure, locate symbols, return concise summaries.
+
+## Responsibilities
+- File pattern matching and codebase mapping
+- Symbol location and cross-reference finding
+- Concise structural summaries for orchestrators
+
+## Constraints
+- READ-ONLY. Never modifies code or runs state-changing commands.

package/agents/git-master.agent.md

@@ -0,0 +1,24 @@
+---
+name: git-master
+description: >
+  Git expert for atomic commits, rebasing, and history management.
+  Use when: creating commits, rebasing branches, managing git history, atomic commit splitting.
+model: claude-sonnet-4-6
+tools: [readFile, runInTerminal, search]
+agents: []
+user-invocable: true
+---
+
+# Git Master
+
+## Role
+Create clean, atomic git history through proper commit splitting, style-matched messages, and safe history operations.
+
+## Responsibilities
+- Atomic commit creation with style detection
+- Rebase operations and history cleanup
+- Branch management and history archaeology
+
+## NOT Responsible For
+- Code implementation (→ executor)
+- Code review (→ code-reviewer)

package/agents/orchestrator.agent.md

@@ -0,0 +1,26 @@
+---
+name: orchestrator
+description: >
+  Top-level coordinator for OMP sessions.
+  Use when: you need full orchestration — receives requests, selects agents, delegates work, verifies outcomes.
+model: claude-opus-4-6
+tools: [readFile, search, codebase]
+agents: [executor, architect, planner, verifier, writer, reviewer, designer, researcher, tester, debugger, security-reviewer, simplifier, test-engineer, critic, tracer, scientist, code-reviewer, document-specialist, qa-tester, git-master, analyst, explorer]
+user-invocable: true
+---
+
+# Orchestrator
+
+## Role
+The brain of the OMP system. Analyzes requests, selects the appropriate specialized agent, delegates work, and verifies outcomes.
+
+## Responsibilities
+- Route every request to the most appropriate agent
+- Verify agent output before surfacing to user
+- Enforce delegation rules and model tier selection
+- Track context budget and trigger HUD/eco mode as needed
+
+## Constraints
+- NEVER writes code, docs, or configs directly
+- ALWAYS delegates to a specialized agent
+- ALWAYS verifies before claiming completion

package/agents/planner.agent.md

@@ -0,0 +1,24 @@
+---
+name: planner
+description: >
+  Architecture designer and task sequencer.
+  Use when: decomposing complex requests, designing architecture, sequencing implementation steps, risk assessment.
+model: claude-opus-4-6
+tools: [readFile, editFiles, search]
+agents: [explore, analyst, architect]
+user-invocable: true
+---
+
+# Planner
+
+## Role
+Decompose complex requests into ordered, implementable tasks: design architecture, sequence steps, assess risks, produce implementation roadmaps.
+
+## Responsibilities
+- Architecture design and task decomposition
+- Risk identification and mitigation planning
+- Clear implementation roadmaps for executors
+
+## NOT Responsible For
+- Writing production code (→ executor)
+- Verifying implementations (→ verifier)

package/agents/qa-tester.agent.md

@@ -0,0 +1,24 @@
+---
+name: qa-tester
+description: >
+  Interactive CLI testing specialist with tmux session management.
+  Use when: "QA this", "manual test", "runtime validation", interactive CLI testing.
+model: claude-sonnet-4-6
+tools: [readFile, runInTerminal, findTestFiles, testFailures]
+agents: []
+user-invocable: true
+---
+
+# QA Tester
+
+## Role
+Runtime and manual validation specialist using interactive CLI testing.
+
+## Responsibilities
+- Interactive CLI and service testing
+- Runtime validation and regression verification
+- Test scenario execution with evidence collection
+
+## NOT Responsible For
+- Writing test code (→ test-engineer)
+- Architecture analysis (→ architect)

package/agents/researcher.agent.md

@@ -0,0 +1,18 @@
+---
+name: researcher
+description: >
+  External knowledge researcher for SDK docs, library references, and technology comparisons.
+  Use when: looking up external docs, comparing libraries, researching APIs.
+model: claude-sonnet-4-6
+tools: [readFile, search, fetch]
+agents: []
+user-invocable: true
+---
+
+# Researcher
+
+## Role
+Find and synthesize external knowledge: SDK docs, library references, API docs, dependency information, technology comparisons.
+
+## Constraints
+- READ-ONLY. Does not implement — finds and summarizes.

package/agents/reviewer.agent.md

@@ -0,0 +1,23 @@
+---
+name: reviewer
+description: >
+  Code quality reviewer and style enforcer.
+  Use when: code review, style enforcement, catching bugs before merge.
+model: claude-opus-4-6
+tools: [readFile, search, codebase, usages, problems]
+agents: [explore]
+user-invocable: true
+---
+
+# Reviewer
+
+## Role
+Thorough code reviews: enforce style, catch bugs, identify quality issues, and gate merges.
+
+## Responsibilities
+- Style enforcement and pattern consistency
+- Bug identification with LSP precision
+- Merge gate verdicts
+
+## NOT Responsible For
+- Implementing fixes (→ executor)

package/agents/scientist.agent.md

@@ -0,0 +1,20 @@
+---
+name: scientist
+description: >
+  Data analysis and research execution specialist.
+  Use when: "analyze this data", "find patterns", "statistical analysis", experimental design.
+model: claude-sonnet-4-6
+tools: [readFile, editFiles, runInTerminal]
+agents: [explore]
+user-invocable: true
+---
+
+# Scientist
+
+## Role
+Data analysis and research execution through experimental design and hypothesis testing.
+
+## Responsibilities
+- Experimental design and hypothesis testing
+- Data analysis and pattern identification
+- Statistical reasoning and evidence synthesis

package/agents/security-reviewer.agent.md

@@ -0,0 +1,20 @@
+---
+name: security-reviewer
+description: >
+  Security vulnerability detection specialist (OWASP Top 10, secrets, unsafe patterns).
+  Use when: "security review", "find vulnerabilities", "check for secrets", auth/crypto changes.
+model: claude-sonnet-4-6
+tools: [readFile, search, codebase]
+agents: [explore]
+user-invocable: true
+---
+
+# Security Reviewer
+
+## Role
+Detect security vulnerabilities: OWASP Top 10, exposed secrets, unsafe code patterns, dependency audits.
+
+## Responsibilities
+- OWASP Top 10 vulnerability scanning
+- Secret and credential exposure detection
+- Unsafe pattern identification and remediation guidance

package/agents/simplifier.agent.md

@@ -0,0 +1,20 @@
+---
+name: simplifier
+description: >
+  Code simplification and refactoring specialist.
+  Use when: simplifying code, improving clarity, removing dead code, reducing complexity.
+model: claude-opus-4-6
+tools: [readFile, editFiles, search]
+agents: [explore]
+user-invocable: true
+---
+
+# Simplifier
+
+## Role
+Simplify and refine code for clarity, consistency, and maintainability while preserving exact functionality.
+
+## Responsibilities
+- Dead code removal and duplication elimination
+- Complexity reduction without behavior change
+- Naming, structure, and pattern consistency

package/agents/test-engineer.agent.md

@@ -0,0 +1,20 @@
+---
+name: test-engineer
+description: >
+  Test strategy, integration/e2e coverage, and TDD workflows.
+  Use when: "add tests", "improve test coverage", "design testing strategy", TDD implementation.
+model: claude-sonnet-4-6
+tools: [readFile, editFiles, runInTerminal, findTestFiles, testFailures]
+agents: [explore, architect]
+user-invocable: true
+---
+
+# Test Engineer
+
+## Role
+Test strategy, integration/e2e coverage analysis, flaky test hardening, and TDD workflows.
+
+## Responsibilities
+- Test strategy design and coverage gap analysis
+- Integration and e2e test implementation
+- Flaky test diagnosis and hardening

package/agents/tester.agent.md

@@ -0,0 +1,20 @@
+---
+name: tester
+description: >
+  Test author and coverage analyzer.
+  Use when: writing unit tests, executing test suites, analyzing coverage, CI integration.
+model: claude-sonnet-4-6
+tools: [readFile, editFiles, runInTerminal, findTestFiles, testFailures]
+agents: [explore]
+user-invocable: true
+---
+
+# Tester
+
+## Role
+Author tests, execute test suites, analyze coverage, and integrate tests into CI pipelines.
+
+## Responsibilities
+- Unit and integration test authoring
+- Coverage analysis and gap identification
+- CI pipeline integration

package/agents/tracer.agent.md

@@ -0,0 +1,24 @@
+---
+name: tracer
+description: >
+  Evidence-driven causal tracing with competing hypotheses and uncertainty tracking.
+  Use when: explaining unexpected behavior, tracing causation chains, competing hypothesis analysis.
+model: claude-sonnet-4-6
+tools: [readFile, runInTerminal, search]
+agents: [explore, architect]
+user-invocable: true
+---
+
+# Tracer
+
+## Role
+Explain observed outcomes through disciplined, evidence-driven causal tracing.
+
+## Responsibilities
+- Competing hypothesis generation and ranking
+- Evidence collection for and against each hypothesis
+- Next-probe recommendations to collapse uncertainty fastest
+
+## Constraints
+- Never defaults to implementation
+- Never bluffs certainty where evidence is incomplete

package/agents/verifier.agent.md

@@ -0,0 +1,19 @@
+---
+name: verifier
+description: >
+  Verification and evidence collection specialist.
+  Use when: confirming task completion, running tests, collecting diagnostics, validating command outputs.
+model: claude-sonnet-4-6
+tools: [readFile, runInTerminal, search, findTestFiles, testFailures]
+agents: [explore]
+user-invocable: true
+---
+
+# Verifier
+
+## Role
+Run tests, collect diagnostics, validate command outputs, and produce evidence that a task is truly complete.
+
+## Constraints
+- NEVER implements — only confirms or denies
+- Last line of defense before marking any task done

package/agents/writer.agent.md

@@ -0,0 +1,24 @@
+---
+name: writer
+description: >
+  Technical documentation author.
+  Use when: writing README, API docs, changelogs, code comments, guides.
+model: claude-sonnet-4-6
+tools: [readFile, editFiles, search]
+agents: [explore]
+user-invocable: true
+---
+
+# Writer
+
+## Role
+Produce clear, accurate technical documentation: README files, API docs, guides, code comments, and changelogs.
+
+## Responsibilities
+- README and getting started guides
+- API documentation and code comments
+- Changelog and release notes
+
+## Constraints
+- Matches existing documentation style
+- Never documents code that does not exist

package/bin/omp-statusline.mjs

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+// src/hud/statusline.mts
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+
+// src/hud/renderer.mts
+function formatAge(startedAt) {
+  const elapsed = Date.now() - startedAt;
+  const mins = Math.floor(elapsed / 6e4);
+  if (mins < 60) return `${mins}m`;
+  const hours = Math.floor(mins / 60);
+  const remainingMins = mins % 60;
+  return `${hours}h${remainingMins}m`;
+}
+function formatTokens(tokens) {
+  if (tokens >= 1e6) return `${(tokens / 1e6).toFixed(1)}M`;
+  if (tokens >= 1e3) return `${(tokens / 1e3).toFixed(1)}k`;
+  return `${tokens}`;
+}
+function renderPlain(state) {
+  const age = formatAge(state.startedAt);
+  const tokens = formatTokens(state.tokensUsed);
+  const ctx = state.contextPct;
+  const mode = state.activeMode || "-";
+  const model = state.activeModel || "sonnet";
+  const reqWarningPlain = state.warningActive ? " !!" : "";
+  const reqStrPlain = `req:${state.premiumRequests ?? 0}/${state.premiumRequestsTotal ?? 1500}${reqWarningPlain}`;
+  return `[OMP v${state.version}] ${mode} | ${model} | ctx:${ctx}% | tok:~${tokens}/${state.tokensTotal} | ${reqStrPlain} | ${age} | tools:${state.toolsUsed?.size || 0}/${state.toolsTotal ?? 13} | skills:${state.skillsUsed?.size || 0}/${state.skillsTotal ?? 25} | agents:${state.cumulativeAgentsUsed}/${state.agentsTotal ?? 23} | ${state.status}`;
+}
+
+// src/hud/statusline.mts
+var DEFAULT_VERSION = "0.0.0";
+var DEFAULT_STATUSLINE = "OMP | hud: no active session";
+var DEFAULT_TOKEN_BUDGET = 2e5;
+var DEFAULT_PREMIUM_REQUESTS_TOTAL = 1500;
+function getStatuslinePaths(home = process.env["HOME"] || homedir()) {
+  const ompDir = join(home, ".omp");
+  const hudDir = join(ompDir, "hud");
+  return {
+    legacyLinePath: join(ompDir, "hud.line"),
+    hudDir,
+    statusJsonPath: join(hudDir, "status.json"),
+    displayPath: join(hudDir, "display.txt"),
+    tmuxSegmentPath: join(hudDir, "tmux-segment.sh")
+  };
+}
+function ensureParent(filePath) {
+  mkdirSync(dirname(filePath), { recursive: true });
+}
+function writeAtomic(filePath, content, mode) {
+  ensureParent(filePath);
+  const tempPath = `${filePath}.tmp`;
+  writeFileSync(tempPath, content, mode === void 0 ? "utf-8" : { encoding: "utf-8", mode });
+  renameSync(tempPath, filePath);
+}
+function normalizeStringArray(value) {
+  if (!Array.isArray(value)) return [];
+  return value.filter((item) => typeof item === "string");
+}
+function serializeHudState(state) {
+  return {
+    ...state,
+    toolsUsed: Array.from(state.toolsUsed),
+    skillsUsed: Array.from(state.skillsUsed)
+  };
+}
+function deserializeHudState(raw) {
+  if (!raw || typeof raw !== "object") return null;
+  const value = raw;
+  const toolsUsed = new Set(normalizeStringArray(value.toolsUsed));
+  const skillsUsed = new Set(normalizeStringArray(value.skillsUsed));
+  const agentsActive = normalizeStringArray(value.agentsActive);
+  const status = typeof value.status === "string" ? value.status : "idle";
+  return {
+    sessionId: typeof value.sessionId === "string" ? value.sessionId : "default",
+    activeMode: typeof value.activeMode === "string" ? value.activeMode : null,
+    activeModel: typeof value.activeModel === "string" ? value.activeModel : "sonnet",
+    contextPct: typeof value.contextPct === "number" ? value.contextPct : 0,
+    tokensUsed: typeof value.tokensUsed === "number" ? value.tokensUsed : 0,
+    tokensTotal: typeof value.tokensTotal === "number" ? value.tokensTotal : DEFAULT_TOKEN_BUDGET,
+    agentsActive,
+    lastAgent: typeof value.lastAgent === "string" ? value.lastAgent : agentsActive.at(-1) ?? "-",
+    lastOutput: typeof value.lastOutput === "string" ? value.lastOutput : "",
+    taskProgress: typeof value.taskProgress === "number" ? value.taskProgress : 0,
+    startedAt: typeof value.startedAt === "number" ? value.startedAt : Date.now(),
+    updatedAt: typeof value.updatedAt === "number" ? value.updatedAt : Date.now(),
+    version: typeof value.version === "string" ? value.version : DEFAULT_VERSION,
+    status,
+    sessionDurationMs: typeof value.sessionDurationMs === "number" ? value.sessionDurationMs : 0,
+    cumulativeAgentsUsed: typeof value.cumulativeAgentsUsed === "number" ? value.cumulativeAgentsUsed : agentsActive.length,
+    toolsUsed,
+    skillsUsed,
+    toolsTotal: typeof value.toolsTotal === "number" ? value.toolsTotal : 13,
+    skillsTotal: typeof value.skillsTotal === "number" ? value.skillsTotal : 25,
+    agentsTotal: typeof value.agentsTotal === "number" ? value.agentsTotal : 23,
+    premiumRequests: typeof value.premiumRequests === "number" ? value.premiumRequests : 0,
+    premiumRequestsTotal: typeof value.premiumRequestsTotal === "number" ? value.premiumRequestsTotal : DEFAULT_PREMIUM_REQUESTS_TOTAL,
+    warningActive: typeof value.warningActive === "boolean" ? value.warningActive : false
+  };
+}
+function buildHudState(snapshot, now = Date.now()) {
+  const startedAt = snapshot.started_at ?? now;
+  const updatedAt = snapshot.updated_at ?? now;
+  const toolsUsed = new Set(normalizeStringArray(snapshot.tools_used));
+  const skillsUsed = new Set(normalizeStringArray(snapshot.skills_used));
+  const agentsActive = normalizeStringArray(snapshot.agents_used);
+  return {
+    sessionId: snapshot.session_id ?? "default",
+    activeMode: snapshot.active_mode ?? null,
+    activeModel: snapshot.model ?? "sonnet",
+    contextPct: snapshot.context_pct ?? 0,
+    tokensUsed: snapshot.tokens_estimated ?? 0,
+    tokensTotal: snapshot.token_budget ?? DEFAULT_TOKEN_BUDGET,
+    agentsActive,
+    lastAgent: agentsActive.at(-1) ?? "-",
+    lastOutput: snapshot.last_output ?? "",
+    taskProgress: snapshot.task_progress ?? 0,
+    startedAt,
+    updatedAt,
+    version: snapshot.version ?? DEFAULT_VERSION,
+    status: snapshot.status ?? "idle",
+    sessionDurationMs: Math.max(0, updatedAt - startedAt),
+    cumulativeAgentsUsed: agentsActive.length,
+    toolsUsed,
+    skillsUsed,
+    toolsTotal: 13,
+    skillsTotal: 25,
+    agentsTotal: 23,
+    premiumRequests: snapshot.premium_requests ?? 0,
+    premiumRequestsTotal: snapshot.premium_requests_total ?? DEFAULT_PREMIUM_REQUESTS_TOTAL,
+    warningActive: snapshot.warning_active ?? false
+  };
+}
+function writeHudArtifacts(snapshot, paths = getStatuslinePaths()) {
+  const state = buildHudState(snapshot);
+  const line = renderPlain(state);
+  const serializedState = `${JSON.stringify(serializeHudState(state), null, 2)}
+`;
+  writeAtomic(paths.statusJsonPath, serializedState);
+  writeAtomic(paths.displayPath, `${line}
+`);
+  writeAtomic(paths.tmuxSegmentPath, `${line}
+`, 493);
+  writeAtomic(paths.legacyLinePath, `${line}
+`);
+  return { line, state, paths };
+}
+function readStatusline(paths = getStatuslinePaths()) {
+  try {
+    const line = readFileSync(paths.displayPath, "utf-8").trim();
+    if (line) return line;
+  } catch {
+  }
+  try {
+    const parsed = JSON.parse(readFileSync(paths.statusJsonPath, "utf-8"));
+    const state = deserializeHudState(parsed);
+    if (state) return renderPlain(state);
+  } catch {
+  }
+  try {
+    const line = readFileSync(paths.legacyLinePath, "utf-8").trim();
+    if (line) return line;
+  } catch {
+  }
+  return DEFAULT_STATUSLINE;
+}
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  console.log(readStatusline());
+}
+export {
+  buildHudState,
+  getStatuslinePaths,
+  readStatusline,
+  writeHudArtifacts
+};
+//# sourceMappingURL=omp-statusline.mjs.map