@minhpnq1807/contextos 0.5.11 → 0.5.12

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.5.12
+
+- Makes `ctx sync --workflows` synchronize unique workflow files to global Claude, Codex, and Antigravity workflow roots.
+- Adds `ctx sync --workflows --agents ...` and `--dry-run`, with workflow-name dedupe to avoid duplicated workflow suggestions across agents.
+
 ## 0.5.11
 
 - Adds Antigravity workflow discovery roots under `.gemini/workflows`, `.gemini/antigravity/workflows`, and `.gemini/antigravity-cli/workflows`.

package/README.md

@@ -216,10 +216,12 @@ After this, `ctx debug -- "task"` and prompt hooks can suggest skills from `~/.c
 
 ## Workflow Discovery
 
-ContextOS can also index Claude/Codex workflow markdown files and suggest the right workflow for the current task:
+ContextOS can also sync Claude/Codex/Antigravity workflow markdown files and suggest the right workflow for the current task:
 
 ```bash
 ctx sync --workflows
+ctx sync --workflows --agents codex,claude,agy
+ctx sync --workflows --dry-run
 ```
 
 It scans project workflows first, then global workflows:
@@ -239,6 +241,8 @@ It scans project workflows first, then global workflows:
 
 Workflow files do not need YAML frontmatter. ContextOS reads the top `#` heading, section headings, and referenced agent names such as `planner`, `tester`, `code-reviewer`, and `docs-manager`, then warms semantic embeddings. Prompt hooks inject a `Suggested workflow for this task` section only when a workflow is relevant enough.
 
+`ctx sync --workflows` reads every known project/global workflow root, keeps the first workflow for each filename/name according to root priority, then copies that unique set to the selected global agent roots. This prevents duplicate `primary-workflow` suggestions when the same workflow exists in Claude, Codex, and Antigravity directories.
+
 ## Modes
 
 Injection mode is the default:
@@ -384,7 +388,9 @@ This warning comes from a transitive dependency in the local embedding/WASM stac
 | `ctx sync --skills --agents <list>` | Syncs skills only for selected agents. | You want to target a subset such as `codex,claude` or `codex,claude,agy`. | Runs `skillshare sync --agents <list>` with `agy` normalized to `antigravity`, then refreshes skill embeddings. |
 | `ctx sync --skills --dry-run` | Previews skillshare sync. | You want to inspect behavior before changing skill directories. | Runs `skillshare sync --dry-run` and skips embedding rebuild. |
 | `ctx sync --skills --no-collect` | Skips collecting existing agent skills into skillshare. | You already manage `~/.config/skillshare/skills` and only want to push it out. | Initializes/syncs skillshare without running `skillshare backup` or `skillshare collect --all`. |
-| `ctx sync --workflows` | Indexes agent workflow markdown files for prompt-time workflow suggestions. | You use `.claude/workflows/` or `.codex/workflows/` and want ContextOS to suggest the best workflow chain for each task. | Scans project/global workflow folders, parses headings and agent chain mentions, warms workflow embeddings, and makes `ctx debug`/prompt hooks show relevant workflow hints. |
+| `ctx sync --workflows` | Syncs and indexes agent workflow markdown files for prompt-time workflow suggestions. | You use `.claude/workflows/`, `.codex/workflows/`, or Antigravity workflow folders and want every agent to see the same deduped workflow set. | Scans project/global workflow folders, dedupes by workflow name, copies unique workflows to selected global agent roots, warms workflow embeddings, and makes `ctx debug`/prompt hooks show relevant workflow hints. |
+| `ctx sync --workflows --agents <list>` | Syncs workflows only for selected agents. | You want a subset such as `codex,claude` or `codex,claude,agy`. | Accepts comma-separated `codex`, `claude`, `agy`, or `antigravity`; `agy` writes the Gemini/Antigravity workflow roots. |
+| `ctx sync --workflows --dry-run` | Previews workflow sync without writing files. | You want to inspect source workflows and target roots first. | Prints planned sync/index output and skips copying target files. |
 | `ctx embeddings warm -- "task"` | Prepares local semantic embedding caches. | First install, CI smoke checks, or after changing AGENTS.md/project files/skills/workflows. | Loads/downloads `Xenova/all-MiniLM-L6-v2` and writes rule, file-path, skill, and workflow vectors to `~/.ctx/contextos/embeddings.db`. |
 | `ctx ruler -- <args>` | Forwards args to the installed `ruler` CLI. | You need native Ruler commands such as `init`, `apply`, or `revert`. | Preserves Ruler stdout/stderr and exit status. |
 | `ctx skillshare -- <args>` | Forwards args to the installed `skillshare` CLI. | You need native skillshare commands such as `status`, `target list`, `doctor`, `push`, or `pull`. | Preserves skillshare stdout/stderr and exit status. |

package/bin/ctx.js

@@ -63,6 +63,8 @@ Usage:
   ctx sync --rules --no-import-codex-mcp
   ctx sync --skills
   ctx sync --workflows
+  ctx sync --workflows --agents codex,claude,agy
+  ctx sync --workflows --dry-run
   ctx sync --skills --dry-run
   ctx sync --skills --no-collect
   ctx sync --skills --agents codex,claude,antigravity
@@ -571,7 +573,8 @@ try {
       await syncWorkflows({
         cwd: process.cwd(),
         dataDir: contextOSDataDir(),
-        allowRemote: !isModelCacheReady(contextOSDataDir())
+        allowRemote: !isModelCacheReady(contextOSDataDir()),
+        args: args.slice(1)
       });
     } else if (args.includes("--skills")) {
       await syncSkills({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minhpnq1807/contextos",
-  "version": "0.5.11",
+  "version": "0.5.12",
   "description": "Task-aware AGENTS.md context injection and compliance reporting for Codex, Claude Code, and Antigravity.",
   "type": "module",
   "bin": {

package/plugins/ctx/lib/workflow-discoverer.js

@@ -8,6 +8,7 @@ const DEFAULT_LIMIT = 2;
 const MIN_WORKFLOW_BYTES = 100;
 const MAX_DESCRIPTION_CHARS = 500;
 const DEFAULT_EMBEDDING_CANDIDATES = 40;
+const DEFAULT_SYNC_AGENTS = ["claude", "codex", "agy"];
 const KNOWN_AGENT_NAMES = new Set([
   "planner",
   "tester",
@@ -42,6 +43,29 @@ export function workflowSearchRoots({ cwd = process.cwd(), home = os.homedir() }
   ];
 }
 
+export function workflowGlobalRoots({ home = os.homedir(), agents = DEFAULT_SYNC_AGENTS } = {}) {
+  const normalizedAgents = parseWorkflowAgents(agents);
+  const roots = [];
+  if (normalizedAgents.includes("claude")) roots.push(path.join(home, ".claude", "workflows"));
+  if (normalizedAgents.includes("codex")) roots.push(path.join(home, ".codex", "workflows"));
+  if (normalizedAgents.includes("agy")) {
+    roots.push(path.join(home, ".gemini", "workflows"));
+    roots.push(path.join(home, ".gemini", "antigravity", "workflows"));
+    roots.push(path.join(home, ".gemini", "antigravity-cli", "workflows"));
+  }
+  return roots;
+}
+
+export function parseWorkflowAgents(value = DEFAULT_SYNC_AGENTS) {
+  const raw = Array.isArray(value) ? value : String(value || "").split(",");
+  const agents = raw
+    .map((agent) => String(agent || "").trim().toLowerCase())
+    .map((agent) => agent === "antigravity" ? "agy" : agent)
+    .filter(Boolean);
+  const known = agents.filter((agent) => DEFAULT_SYNC_AGENTS.includes(agent));
+  return [...new Set(known.length ? known : DEFAULT_SYNC_AGENTS)];
+}
+
 export function scanWorkflows({ cwd = process.cwd(), roots = workflowSearchRoots({ cwd }) } = {}) {
   const workflows = [];
   const seen = new Set();
@@ -148,20 +172,67 @@ export async function syncWorkflows({
   cwd = process.cwd(),
   dataDir,
   allowRemote = true,
+  args = [],
+  home = os.homedir(),
   logger = console.log
 } = {}) {
-  const workflows = scanWorkflows({ cwd });
-  logger("ContextOS workflow index");
-  logger(`Found workflows: ${workflows.length}`);
+  const options = parseSyncWorkflowArgs(args);
+  const agents = parseWorkflowAgents(options.agents);
+  const workflows = scanWorkflows({ cwd, roots: workflowSearchRoots({ cwd, home }) });
+  const targets = workflowGlobalRoots({ home, agents });
+
+  logger("ContextOS workflow sync");
+  logger(`Agents: ${agents.join(", ")}`);
+  logger(`Found unique workflows: ${workflows.length}`);
   if (workflows.length) {
     for (const workflow of workflows) {
       logger(`- ${workflow.relativePath || workflow.path} (${workflow.chain.join(" -> ") || "no chain"})`);
     }
   }
+  const syncResult = syncWorkflowFiles({ workflows, targets, dryRun: options.dryRun, logger });
   const result = await warmWorkflowEmbeddings({ cwd, dataDir, allowRemote, workflows });
+  logger(`Synced workflows: ${syncResult.copied}${options.dryRun ? " planned" : ""}`);
+  logger(`Skipped duplicates: ${syncResult.duplicates}`);
   logger(`Indexed workflows: ${workflows.length}`);
   if (result.cachePath) logger(`Cache: ${result.cachePath}`);
-  return { workflows, embeddings: result };
+  return { workflows, embeddings: result, sync: syncResult };
+}
+
+function parseSyncWorkflowArgs(args = []) {
+  const agentsFlag = args.indexOf("--agents");
+  return {
+    agents: agentsFlag >= 0 ? args[agentsFlag + 1] : DEFAULT_SYNC_AGENTS,
+    dryRun: args.includes("--dry-run")
+  };
+}
+
+function syncWorkflowFiles({ workflows = [], targets = [], dryRun = false, logger = console.log } = {}) {
+  let copied = 0;
+  let duplicates = 0;
+  const seenNames = new Set();
+  for (const workflow of workflows) {
+    if (seenNames.has(workflow.name)) {
+      duplicates += 1;
+      continue;
+    }
+    seenNames.add(workflow.name);
+    for (const targetRoot of targets) {
+      const targetPath = path.join(targetRoot, `${workflow.name}.md`);
+      const sourceRealPath = safeRealpath(workflow.path) || path.resolve(workflow.path);
+      const targetRealPath = safeRealpath(targetPath) || path.resolve(targetPath);
+      if (sourceRealPath === targetRealPath) continue;
+      if (!dryRun) {
+        fs.mkdirSync(targetRoot, { recursive: true });
+        fs.copyFileSync(workflow.path, targetPath);
+      }
+      copied += 1;
+    }
+  }
+  if (targets.length) {
+    logger(`Target roots: ${targets.length}`);
+    for (const target of targets) logger(`  -> ${target}`);
+  }
+  return { copied, duplicates, targets: targets.length };
 }
 
 function stripFrontmatter(content) {