You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Assimilate safishamsi/graphify into the AgentOS ecosystem as a first-class knowledge-graph capability.
The repository being assimilated is Graphify. Q00/ouroboros-plugins is only the plugin-contract and reference-implementation surface used to express how that external repository becomes AgentOS-native. This issue is not about assimilating ouroboros-plugins itself, and it is not about any unrelated external repository or ecosystem.
The goal is to preserve Graphify's existing user experience while giving it AgentOS semantics:
declared command surface,
scoped permissions,
bounded filesystem/network behavior,
audit and provenance records,
resumable state,
progress reporting,
produced artifacts,
verification evidence,
and handoff artifacts for downstream AgentOS workflows.
This issue follows the capability-assimilation direction from #27:
The result should not be a thin subprocess.run("graphify ...") wrapper. The plugin must translate Graphify into the AgentOS trust, lifecycle, artifact, and handoff model.
optional wiki / Obsidian / SVG / GraphML / Neo4j / callflow HTML outputs
Query operations:
graphify query
graphify path
graphify explain
Optional higher-risk integrations:
URL ingestion
Google Workspace export through gws
video/audio transcription
git hook installation
Neo4j push
MCP stdio server
GitHub PR dashboard helpers
Product thesis
Graphify turns a project or corpus into a durable, queryable knowledge graph. That makes it a strong candidate for AgentOS assimilation because agents can use the graph as structured context instead of repeatedly rereading raw files.
Users should keep the mental model they already have:
/graphify .
/graphify query "what connects auth to the database?"
/graphify path "UserService""DatabasePool"
/graphify explain "RateLimiter"
After assimilation, the AgentOS-facing experience should be command-addressable, permissioned, audited, and handoff-aware:
The exact spelling can evolve. The important property is that Graphify becomes an AgentOS-native capability: every Graphify behavior is represented as an AgentOS command, deferred command, or documented non-goal with explicit permission, risk, audit, provenance, artifact, and handoff semantics.
Core requirement
Expose Graphify's complete skill/CLI capability surface through AgentOS-native plugin commands while preserving the familiar /graphify workflow wherever safe and technically possible.
Each exposed command must define or derive:
command namespace and command name,
argument contract,
risk class,
required and optional permissions,
core capabilities used,
bounded execution semantics,
progress and resumability behavior,
audit events,
provenance metadata,
produced artifacts,
verification evidence,
and handoff artifacts for downstream AgentOS workflows.
Proposed plugin identity
Suggested plugin name:
graphify-kg
Alternative names:
graphify
knowledge-graph
agent-graphify
Recommended namespace:
graphify
This preserves Graphify's existing mental model while staying valid under the current namespace schema.
Suggested repository layout if implemented as a reference plugin in this repository:
Per #27, the repository URL remains the unit of distribution and plugins/graphify-kg/ remains the unit of selection. In either layout, the purpose is to bring Graphify into AgentOS through the plugin contract.
Target command inventory
The MVP should preserve Graphify's skill UX by mapping its upstream command surface into ooo graphify ... commands.
Upstream Graphify UX / CLI
Proposed AgentOS command
Initial risk
Notes
/graphify . / graphify <path>
ooo graphify build <path>
write
Builds graphify-out and attaches handoff/provenance.
/graphify <path> --mode deep
ooo graphify build <path> --mode deep
write
More aggressive relationship extraction; may increase model/API usage.
graphify extract <path>
ooo graphify extract <path>
write
Headless full extraction path; should be the implementation backbone.
/graphify <path> --update / graphify update
ooo graphify update <path>
write
Incremental update after code changes.
/graphify <path> --cluster-only
ooo graphify cluster <path>
write
Recompute communities/report from existing graph.
/graphify <path> --no-viz
ooo graphify build <path> --no-viz
write
Skip HTML but still write report/JSON.
/graphify <path> --wiki
ooo graphify wiki <path>
write
Builds agent-crawlable markdown wiki from graph.
/graphify <path> --obsidian
ooo graphify obsidian <path>
write
Writes Obsidian vault artifacts; path-bounded.
/graphify query "..."
ooo graphify query "..."
read_only / write
Read-only if no memory write; write if saving query evidence.
/graphify path A B
ooo graphify path A B
read_only
Shortest-path evidence between concepts.
/graphify explain X
ooo graphify explain X
read_only
Focused concept explanation from graph.
graphify add <url>
ooo graphify ingest-url <url>
write
Requires network:read; should not be enabled in the local-only MVP.
graphify clone <github-url>
ooo graphify clone <github-url>
write
Requires network and filesystem write; separate trust path.
graphify merge-graphs
ooo graphify merge-graphs ...
write
Useful for multi-repo AgentOS context.
graphify export callflow-html
ooo graphify export callflow-html
write
Generates architecture/call-flow artifact.
graphify tree
ooo graphify tree
write
Emits tree HTML artifact.
graphify benchmark
ooo graphify benchmark
read_only / write
Measures token-reduction evidence; may write report.
graphify global add/list/remove/path
ooo graphify global ...
read_only / write
User-global graph store; requires clear boundary and trust semantics.
graphify hook install/status/uninstall
ooo graphify hook ...
write / destructive
Mutates git hooks; should be explicitly confirmed.
graphify watch <path>
ooo graphify watch <path>
write
Long-running process; may require lifecycle/process-management semantics.
python -m graphify.serve graph.json
ooo graphify mcp serve
read_only / write
MCP stdio server; likely v1 after lifecycle semantics are clearer.
graphify prs ...
ooo graphify prs ...
read_only / write
Overlaps with GitHub PR plugins; handle carefully.
platform install skills
ooo graphify install-platform <platform>
write
Optional; writes external agent config files and should not be in the core MVP.
The MVP does not need to enable every high-risk command at once, but the epic should track the complete inventory so the UX-preservation target is explicit.
Recommended implementation phases
Phase 0 — Contract and command catalog
Add an explicit Graphify command catalog generated or derived from upstream CLI/skill docs.
Classify every command by:
risk: read_only, write, destructive,
required permissions,
optional permissions,
produced artifact types,
resumability behavior,
and handoff behavior.
Decide whether this repository hosts a reference skeleton only or the full plugin.
Graphify is a strong proof case for capability assimilation because it is neither a simple CLI nor a pure prompt pack. It is a cross-agent skill, Python library, CLI, artifact generator, query engine, optional MCP server, and persistent project-memory layer.
Assimilating Graphify correctly would prove that an external agentic tool can enter the AgentOS ecosystem while preserving safety:
This plugin should clarify how future OSS tools that produce durable agent context can become AgentOS-native without becoming unbounded shell wrappers or core features.
Acceptance criteria
A Graphify plugin design is added or tracked with a complete command inventory.
The command namespace preserves the upstream /graphify mental model, preferably as ooo graphify ....
Every upstream Graphify skill/CLI behavior is mapped to an AgentOS command, deferred command, or explicitly rejected command with rationale.
The local MVP commands are implemented or specified:
build
extract
update
query
path
explain
Each command has risk classification.
Required and optional permissions are documented.
Core capabilities are declared separately from external permissions.
The plugin produces or specifies AgentOS handoff artifacts for graph builds and graph queries.
Graphify artifacts are summarized by path, hash, size, and graph statistics rather than copied wholesale into provenance.
The plugin emits or specifies standard plugin audit events.
Missing dependencies and optional extras are represented as blocked/failure outcomes.
Semantic/model-backed extraction behavior is explicitly permissioned and documented.
High-risk features such as hooks, URL ingestion, Google Workspace, Neo4j push, MCP server, and global graph mutation are either deferred or guarded by explicit permissions and confirmations.
Tests or fixtures validate manifest compliance and command catalog coverage.
Open design questions
Should the first implementation live in Q00/ouroboros-plugins as a contract-bearing reference plugin, or in a separate ouroboros-graphify repository with this repo hosting only the RFC/reference skeleton?
Should graphifyy be vendored, installed as an external tool, or resolved through a plugin-local environment?
Does the current manifest schema need a dependency declaration field, or can dependency checks remain runtime-blocking behavior for v0?
Should query commands write memory artifacts by default, or remain strictly read-only unless --save is passed?
Should graphify prs remain inside this plugin, or should it be delegated to GitHub PR plugins to avoid capability overlap?
How should long-running watch and MCP server modes map to AgentOS lifecycle/process semantics?
Should platform installer commands be exposed at all, given that AgentOS should be the execution surface rather than an installer for other agent harnesses?
Summary
Assimilate
safishamsi/graphifyinto the AgentOS ecosystem as a first-class knowledge-graph capability.The repository being assimilated is Graphify.
Q00/ouroboros-pluginsis only the plugin-contract and reference-implementation surface used to express how that external repository becomes AgentOS-native. This issue is not about assimilatingouroboros-pluginsitself, and it is not about any unrelated external repository or ecosystem.The goal is to preserve Graphify's existing user experience while giving it AgentOS semantics:
This issue follows the capability-assimilation direction from #27:
The result should not be a thin
subprocess.run("graphify ...")wrapper. The plugin must translate Graphify into the AgentOS trust, lifecycle, artifact, and handoff model.Source repository to assimilate
Upstream repository:
Snapshot inspected:
6939494b3e76ba94a52d1da6ff1e467206444f722026-05-18T21:57:09+01:00graphifyy0.8.13LICENSEfilegraphify = graphify.__main__:mainObserved upstream shape:
graphify/skill.mdgraphify/skill-codex.mdgraphify/skill-opencode.mdgraphify/skill-aider.mdgraphify/skill-copilot.mdgraphify/skill-claw.mdgraphify/skill-droid.mdgraphify/skill-trae.mdgraphify/skill-kiro.mdgraphify/skill-vscode.mdgraphify/skill-pi.mdgraphify/skill-windows.mdgraphify-out/graph.jsongraphify-out/GRAPH_REPORT.mdgraphify-out/graph.htmlgraphify querygraphify pathgraphify explaingwsProduct thesis
Graphify turns a project or corpus into a durable, queryable knowledge graph. That makes it a strong candidate for AgentOS assimilation because agents can use the graph as structured context instead of repeatedly rereading raw files.
Users should keep the mental model they already have:
After assimilation, the AgentOS-facing experience should be command-addressable, permissioned, audited, and handoff-aware:
The exact spelling can evolve. The important property is that Graphify becomes an AgentOS-native capability: every Graphify behavior is represented as an AgentOS command, deferred command, or documented non-goal with explicit permission, risk, audit, provenance, artifact, and handoff semantics.
Core requirement
Expose Graphify's complete skill/CLI capability surface through AgentOS-native plugin commands while preserving the familiar
/graphifyworkflow wherever safe and technically possible.Each exposed command must define or derive:
Proposed plugin identity
Suggested plugin name:
Alternative names:
Recommended namespace:
This preserves Graphify's existing mental model while staying valid under the current namespace schema.
Suggested repository layout if implemented as a reference plugin in this repository:
Suggested layout if distributed from a separate Graphify integration repository:
Per #27, the repository URL remains the unit of distribution and
plugins/graphify-kg/remains the unit of selection. In either layout, the purpose is to bring Graphify into AgentOS through the plugin contract.Target command inventory
The MVP should preserve Graphify's skill UX by mapping its upstream command surface into
ooo graphify ...commands./graphify ./graphify <path>ooo graphify build <path>writegraphify-outand attaches handoff/provenance./graphify <path> --mode deepooo graphify build <path> --mode deepwritegraphify extract <path>ooo graphify extract <path>write/graphify <path> --update/graphify updateooo graphify update <path>write/graphify <path> --cluster-onlyooo graphify cluster <path>write/graphify <path> --no-vizooo graphify build <path> --no-vizwrite/graphify <path> --wikiooo graphify wiki <path>write/graphify <path> --obsidianooo graphify obsidian <path>write/graphify query "..."ooo graphify query "..."read_only/write/graphify path A Booo graphify path A Bread_only/graphify explain Xooo graphify explain Xread_onlygraphify add <url>ooo graphify ingest-url <url>writenetwork:read; should not be enabled in the local-only MVP.graphify clone <github-url>ooo graphify clone <github-url>writegraphify merge-graphsooo graphify merge-graphs ...writegraphify export callflow-htmlooo graphify export callflow-htmlwritegraphify treeooo graphify treewritegraphify benchmarkooo graphify benchmarkread_only/writegraphify global add/list/remove/pathooo graphify global ...read_only/writegraphify hook install/status/uninstallooo graphify hook ...write/destructivegraphify watch <path>ooo graphify watch <path>writepython -m graphify.serve graph.jsonooo graphify mcp serveread_only/writegraphify prs ...ooo graphify prs ...read_only/writeooo graphify install-platform <platform>writeThe MVP does not need to enable every high-risk command at once, but the epic should track the complete inventory so the UX-preservation target is explicit.
Recommended implementation phases
Phase 0 — Contract and command catalog
read_only,write,destructive,Phase 1 — Local graph build/query MVP
Implement the safe local core:
ooo graphify build <path>ooo graphify extract <path>ooo graphify update <path>ooo graphify query <question>ooo graphify path <a> <b>ooo graphify explain <node>ooo graphify handoffThe MVP should require only:
filesystem:readfilesystem:writeand should use core capabilities such as:
ledger:writestate:writeprovenance:writehandoff:attachprogress:writePhase 2 — Artifact and handoff integration
Convert Graphify outputs into AgentOS-native artifacts:
graph.json,GRAPH_REPORT.md,graph.html, wiki, callflow HTML, etc.;EXTRACTED,INFERRED,AMBIGUOUS);ooo auto, harnesses, and future Workflow IR / Run-Step-Artifact projections.Phase 3 — Semantic extraction and model/API boundaries
Graphify's code extraction is local AST-based, but semantic extraction for docs/PDF/images may call model APIs depending on backend configuration.
This phase should:
network:write,network:read,shell:execute, or a more specific future permission.Phase 4 — Optional integrations
Add higher-risk Graphify features only after the MVP proves the core assimilation path:
gws,watchlong-running mode,Each optional integration should have explicit permission/risk/trust semantics and may justify a separate plugin or command family.
Manifest sketch
A v0.1-compatible MVP manifest could look like this:
{ "schema_version": "0.1", "name": "graphify-kg", "version": "0.1.0", "description": "Assimilate Graphify knowledge-graph generation and querying into AgentOS handoff, provenance, and audit contracts.", "source": { "type": "local_path", "path": "plugins/graphify-kg" }, "commands": [ { "namespace": "graphify", "name": "build", "summary": "Build a knowledge graph for a bounded local corpus and attach an AgentOS handoff artifact.", "usage": "ooo graphify build <path>", "risk": "write", "requires_confirmation": false, "arguments": [ { "name": "path", "type": "path", "required": true, "description": "Repo-relative or absolute corpus path to graph." } ] }, { "namespace": "graphify", "name": "query", "summary": "Query an existing Graphify graph and return scoped evidence.", "usage": "ooo graphify query <question>", "risk": "read_only", "requires_confirmation": false, "arguments": [ { "name": "question", "type": "string", "required": true, "description": "Natural-language graph query." } ] } ], "capabilities": [ { "name": "ledger", "access": "write", "reason": "Record graph build/query evidence and decisions." }, { "name": "provenance", "access": "write", "reason": "Record graph artifact paths, hashes, counts, and source corpus metadata." }, { "name": "state", "access": "write", "reason": "Persist graph build state and latest artifact references." }, { "name": "handoff", "access": "attach", "reason": "Attach graph report and query evidence to downstream AgentOS workflows." }, { "name": "progress", "access": "write", "reason": "Report long graph build progress." } ], "permissions": [ { "scope": "filesystem:read", "risk": "read_only", "required": true, "reason": "Read bounded local corpus files and existing graph artifacts." }, { "scope": "filesystem:write", "risk": "write", "required": true, "reason": "Write graphify-out and AgentOS handoff artifacts." } ], "entrypoint": { "type": "command", "command": "python -m graphify_kg_plugin" }, "audit": { "events": [ "plugin.invoked", "plugin.permission_used", "plugin.completed", "plugin.failed" ] } }Adapter behavior requirements
The plugin entrypoint should perform a real AgentOS translation layer:
Validate inputs and boundaries
.graphifyignore/ inclusion behavior where applicable.Invoke Graphify safely
graphifyyor optional extras as blocked/failure states, not silent partial success.Capture artifacts
Emit provenance
Attach handoff
Represent outcomes
completedwhen artifacts are produced and validated.failedwhen Graphify execution fails.blockedwhen required dependency/permission/trust is missing.cancelledwhere long-running watch/build flows are interrupted.Permissions and risk model
MVP permissions
Likely future permissions
Risk guidance
query,path,explain:read_onlyif they do not write query memory.build,extract,update,cluster,wiki,obsidian,tree,export:write.hook install,hook uninstall:writewith explicit confirmation; potentiallydestructiveif overwriting existing hooks is possible.neo4j-push:writeordestructivedepending on target database behavior.global remove:writeordestructivedepending on whether it deletes user-global graph state.Non-goals
Q00/ouroboros-pluginsitself as the target repository; Graphify is the assimilation target.Q00/ouroboros-pluginsinto a Graphify marketplace entry./graphifyprompts outside manifest/trust/audit semantics.ooo auto.Why this belongs under the #27 direction
Graphify is a strong proof case for capability assimilation because it is neither a simple CLI nor a pure prompt pack. It is a cross-agent skill, Python library, CLI, artifact generator, query engine, optional MCP server, and persistent project-memory layer.
Assimilating Graphify correctly would prove that an external agentic tool can enter the AgentOS ecosystem while preserving safety:
This plugin should clarify how future OSS tools that produce durable agent context can become AgentOS-native without becoming unbounded shell wrappers or core features.
Acceptance criteria
/graphifymental model, preferably asooo graphify ....buildextractupdatequerypathexplainOpen design questions
Q00/ouroboros-pluginsas a contract-bearing reference plugin, or in a separateouroboros-graphifyrepository with this repo hosting only the RFC/reference skeleton?graphifyybe vendored, installed as an external tool, or resolved through a plugin-local environment?--saveis passed?graphify prsremain inside this plugin, or should it be delegated to GitHub PR plugins to avoid capability overlap?watchand MCP server modes map to AgentOS lifecycle/process semantics?References
Q00/ouroboros-plugins/docs/contract.mdQ00/ouroboros-plugins/docs/lifecycle.mdQ00/ouroboros-plugins/docs/permissions.mdQ00/ouroboros-plugins/docs/audit.mdQ00/ouroboros-plugins/schemas/0.1/plugin.schema.json