# Metagit Graph Maintain

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-metagit-ai-metagit-cli-metagit-graph-maintain`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [metagit-ai](https://agentstack.voostack.com/s/metagit-ai)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [metagit-ai](https://github.com/metagit-ai)
- **Source:** https://github.com/metagit-ai/metagit-cli/tree/main/skills/metagit-graph-maintain
- **Website:** https://metagit-ai.github.io/metagit-cli/

## Install

```sh
agentstack add skill-metagit-ai-metagit-cli-metagit-graph-maintain
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Workspace graph maintenance

Use this skill to discover and keep durable cross-repo edges in `.metagit.yml` `graph.relationships`, then sync them into GitNexus.

## When to use

| Phase | Trigger |
|-------|---------|
| **Discover** | New umbrella workspace, empty `graph.relationships`, or first graph authoring pass |
| **Maintain** | After adding repos, promoting inferred deps, or refreshing GitNexus overlay |

## First-time discovery (report only)

Do **not** apply until the operator approves the discovery report.

```bash
export METAGIT_AGENT_MODE=true
metagit prompt workspace -c .metagit.yml -k graph-discover --text-only
metagit workspace list -c .metagit.yml --json
metagit config graph suggest -c .metagit.yml --json --include-declared --min-confidence all
```

Deliver a **Graph Discovery Report**:

- inferred edges grouped by confidence (`high` / `medium` / `low`)
- gap pairs with no machine path (need operator interview)
- `proposed_manual_edges[]` from interview answers
- `operations_preview` JSON — **not applied**

After sign-off, continue with the maintenance workflow below (or `metagit prompt workspace -k graph-maintain`).

## Maintenance workflow

### 1. Bootstrap context

```bash
export METAGIT_AGENT_MODE=true
metagit prompt workspace -c .metagit.yml -k graph-maintain --text-only
metagit workspace list -c .metagit.yml --json
```

### 2. Suggest candidates

```bash
metagit config graph suggest -c .metagit.yml --json
metagit config graph suggest -c .metagit.yml --min-confidence high --json
```

MCP: `metagit_suggest_graph_relationships`

Review `candidates[]` for `confidence`, `evidence`, and `source_edge_type`. Skip low-confidence edges unless the operator approves.

### 3. Preview and apply

```bash
# Save operations from suggest JSON to ops.json, then:
metagit config preview -c .metagit.yml --file ops.json

# Apply all suggested candidates (medium+ confidence by default)
metagit config graph suggest -c .metagit.yml --apply

# Apply selected ids only
metagit config graph suggest -c .metagit.yml --apply \
  --candidate-id alpha-api-to-beta-worker-depends_on

metagit config validate -c .metagit.yml
```

MCP: `metagit_apply_graph_relationships` (`dry_run: true` to preview, `save: true` to persist)

### 4. Export and ingest GitNexus overlay

```bash
./skills/metagit-gitnexus/scripts/ingest-workspace-graph.sh -c .metagit.yml
```

Or manually:

```bash
metagit config graph export -c .metagit.yml --format tool-calls --output /tmp/graph-tool-calls.json
```

Then run each `gitnexus_cypher` call (or use the ingest script).

### 5. Refresh per-repo indexes

```bash
./skills/metagit-gitnexus/scripts/analyze-targets.sh  
```

### 6. Sync GitNexus group (cross-index)

After repos are indexed, align the workspace with a GitNexus group:

```bash
./skills/metagit-gitnexus/scripts/sync-group.sh -c .metagit.yml
# MCP: metagit_gitnexus_group_sync
```

Enables `gitnexus group query` / `group impact` across member repos.

## Output contract

Return:

- candidate count and applied count
- validation result after apply
- GitNexus ingest status (schema + statement count)
- repos still stale/missing in GitNexus registry

## Safety

- Default `--min-confidence medium`; require operator approval for `--min-confidence all`
- Never remove or rewrite existing manual relationships
- Use `--dry-run` / `dry_run: true` before first apply in a workspace
- Do not ingest Cypher until `metagit config validate` passes

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [metagit-ai](https://github.com/metagit-ai)
- **Source:** [metagit-ai/metagit-cli](https://github.com/metagit-ai/metagit-cli)
- **License:** MIT
- **Homepage:** https://metagit-ai.github.io/metagit-cli/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-metagit-ai-metagit-cli-metagit-graph-maintain
- Seller: https://agentstack.voostack.com/s/metagit-ai
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.