agent-flutter 0.1.1 → 0.1.3

package/README.md

@@ -14,12 +14,15 @@ By default `init` installs adapters for all supported IDEs:
 - Cursor
 - Windsurf
 - Cline
+- GitHub (Copilot)
 
 ## Commands
 
 ```bash
 npx agent-flutter@latest init --ide all --cwd /path/to/project --force
 npx agent-flutter@latest init --ide trae,codex
+npx agent-flutter@latest sync
+npx agent-flutter@latest sync --ide trae,codex,github
 npx agent-flutter@latest list --cwd /path/to/project
 ```
 
@@ -49,9 +52,10 @@ npm run release:major
 
 ## Installed files
 
-- Shared pack: `.agent-flutter/`
+- Shared pack (for Trae/Codex/Cursor/Windsurf/Cline): `.agent-flutter/`
 - Trae: `.trae/`
 - Codex: `AGENTS.md`
 - Cursor: `.cursor/rules/agent-flutter.mdc`
 - Windsurf: `.windsurf/rules/agent-flutter.md`
 - Cline: `.clinerules/agent-flutter.md`
+- GitHub: `.github/skills/`, `.github/rules/`, `.github/copilot-instructions.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-flutter",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Portable Flutter skill/rule pack initializer for multiple AI IDEs.",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -2,17 +2,19 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 
-const SUPPORTED_IDES = ['trae', 'codex', 'cursor', 'windsurf', 'cline'];
+const SUPPORTED_IDES = ['trae', 'codex', 'cursor', 'windsurf', 'cline', 'github'];
 
 const USAGE = `
 agent-flutter
 
 Usage:
-  npx agent-flutter@latest init [--ide all|trae,codex,cursor,windsurf,cline] [--cwd <project_dir>] [--force]
+  npx agent-flutter@latest init [--ide all|trae,codex,cursor,windsurf,cline,github] [--cwd <project_dir>] [--force]
+  npx agent-flutter@latest sync [--ide all|trae,codex,cursor,windsurf,cline,github] [--cwd <project_dir>]
   npx agent-flutter@latest list [--cwd <project_dir>]
 
 Commands:
   init   Install shared Flutter skills/rules and IDE adapters.
+  sync   Update installed shared pack and adapters from latest template.
   list   Print available skills/rules from the shared pack.
 `;
 
@@ -29,6 +31,9 @@ export async function runCli(argv) {
     case 'init':
       await runInit(options);
       return;
+    case 'sync':
+      await runSync(options);
+      return;
     case 'list':
       await runList(options);
       return;
@@ -82,17 +87,76 @@ async function runInit(options) {
   const ideTargets = resolveIdeTargets(options.get('ide', 'all'));
   const force = options.hasFlag('force');
 
-  const sharedTarget = path.join(projectRoot, '.agent-flutter');
-  if ((await exists(sharedTarget)) && !force) {
-    console.log(`Using existing shared pack: ${sharedTarget}`);
+  await applyPack({
+    templateRoot,
+    projectRoot,
+    ideTargets,
+    force,
+    mode: 'install',
+  });
+
+  console.log('');
+  console.log('Done.');
+  console.log('Use --force to overwrite existing adapters.');
+}
+
+async function runSync(options) {
+  const packageRoot = getPackageRoot();
+  const templateRoot = path.join(packageRoot, 'templates', 'shared');
+  await assertDirExists(templateRoot, `Shared template not found: ${templateRoot}`);
+
+  const projectRoot = path.resolve(options.get('cwd', process.cwd()));
+  await assertDirExists(projectRoot, `Project directory not found: ${projectRoot}`);
+
+  let ideTargets;
+  const ideOption = options.get('ide', null);
+  if (ideOption) {
+    ideTargets = resolveIdeTargets(ideOption);
   } else {
-    await copyTemplateDirectory({
-      sourceDir: templateRoot,
-      destinationDir: sharedTarget,
-      projectRoot,
-      force: true,
-    });
-    console.log(`Installed shared pack: ${sharedTarget}`);
+    ideTargets = await detectInstalledIdeTargets(projectRoot);
+    if (ideTargets.size) {
+      console.log(`Detected adapters: ${[...ideTargets].join(', ')}`);
+    } else {
+      ideTargets = new Set(SUPPORTED_IDES);
+      console.log('No existing adapters detected. Syncing all adapters.');
+    }
+  }
+
+  await applyPack({
+    templateRoot,
+    projectRoot,
+    ideTargets,
+    force: true,
+    mode: 'sync',
+  });
+
+  console.log('');
+  console.log('Sync completed.');
+}
+
+async function applyPack({
+  templateRoot,
+  projectRoot,
+  ideTargets,
+  force,
+  mode,
+}) {
+  const verb = mode === 'sync' ? 'Synced' : 'Installed';
+  const sharedPackIdes = new Set(['trae', 'codex', 'cursor', 'windsurf', 'cline']);
+  const requiresSharedPack = [...ideTargets].some((ide) => sharedPackIdes.has(ide));
+  const sharedTarget = path.join(projectRoot, '.agent-flutter');
+  if (requiresSharedPack) {
+    if ((await exists(sharedTarget)) && !force) {
+      console.log(`Using existing shared pack: ${sharedTarget}`);
+    } else {
+      await copyTemplateDirectory({
+        sourceDir: templateRoot,
+        destinationDir: sharedTarget,
+        projectRoot,
+        force: true,
+      });
+      console.log(`${verb} shared pack: ${sharedTarget}`);
+    }
   }
 
   if (ideTargets.has('trae')) {
@@ -106,12 +170,15 @@ async function runInit(options) {
         projectRoot,
         force: true,
       });
-      console.log(`Installed Trae adapter: ${traeTarget}`);
+      console.log(`${verb} Trae adapter: ${traeTarget}`);
     }
   }
 
-  const skills = await loadSkillMetadata(path.join(sharedTarget, 'skills'));
-  const rules = await loadRuleMetadata(path.join(sharedTarget, 'rules'));
+  const metadataSource = requiresSharedPack
+    ? sharedTarget
+    : templateRoot;
+  const skills = await loadSkillMetadata(path.join(metadataSource, 'skills'));
+  const rules = await loadRuleMetadata(path.join(metadataSource, 'rules'));
 
   if (ideTargets.has('codex')) {
     const agentsPath = path.join(projectRoot, 'AGENTS.md');
@@ -127,7 +194,7 @@ async function runInit(options) {
     );
     console.log(
       written
-        ? `Installed Codex adapter: ${agentsPath}`
+        ? `${verb} Codex adapter: ${agentsPath}`
         : `Skipped Codex adapter (exists): ${agentsPath}`,
     );
   }
@@ -141,7 +208,7 @@ async function runInit(options) {
     );
     console.log(
       written
-        ? `Installed Cursor adapter: ${cursorPath}`
+        ? `${verb} Cursor adapter: ${cursorPath}`
         : `Skipped Cursor adapter (exists): ${cursorPath}`,
     );
   }
@@ -155,7 +222,7 @@ async function runInit(options) {
     );
     console.log(
       written
-        ? `Installed Windsurf adapter: ${windsurfPath}`
+        ? `${verb} Windsurf adapter: ${windsurfPath}`
         : `Skipped Windsurf adapter (exists): ${windsurfPath}`,
     );
   }
@@ -169,14 +236,72 @@ async function runInit(options) {
     );
     console.log(
       written
-        ? `Installed Cline adapter: ${clinePath}`
+        ? `${verb} Cline adapter: ${clinePath}`
         : `Skipped Cline adapter (exists): ${clinePath}`,
     );
   }
 
-  console.log('');
-  console.log('Done.');
-  console.log('Use --force to overwrite existing adapters.');
+  if (ideTargets.has('github')) {
+    const githubSkillsPath = path.join(projectRoot, '.github', 'skills');
+    if ((await exists(githubSkillsPath)) && !force) {
+      console.log(`Skipped GitHub skills (exists): ${githubSkillsPath}`);
+    } else {
+      await copyTemplateDirectory({
+        sourceDir: path.join(templateRoot, 'skills'),
+        destinationDir: githubSkillsPath,
+        projectRoot,
+        force: true,
+      });
+      console.log(`${verb} GitHub skills: ${githubSkillsPath}`);
+    }
+
+    const githubRulesPath = path.join(projectRoot, '.github', 'rules');
+    if ((await exists(githubRulesPath)) && !force) {
+      console.log(`Skipped GitHub rules (exists): ${githubRulesPath}`);
+    } else {
+      await copyTemplateDirectory({
+        sourceDir: path.join(templateRoot, 'rules'),
+        destinationDir: githubRulesPath,
+        projectRoot,
+        force: true,
+      });
+      console.log(`${verb} GitHub rules: ${githubRulesPath}`);
+    }
+
+    const githubPath = path.join(projectRoot, '.github', 'copilot-instructions.md');
+    const written = await writeTextFile(
+      githubPath,
+      buildGithubCopilotInstructions(),
+      { force },
+    );
+    console.log(
+      written
+        ? `${verb} GitHub adapter: ${githubPath}`
+        : `Skipped GitHub adapter (exists): ${githubPath}`,
+    );
+  }
+}
+
+async function detectInstalledIdeTargets(projectRoot) {
+  const detected = new Set();
+  if (await exists(path.join(projectRoot, '.trae'))) detected.add('trae');
+  if (await exists(path.join(projectRoot, 'AGENTS.md'))) detected.add('codex');
+  if (await exists(path.join(projectRoot, '.cursor', 'rules', 'agent-flutter.mdc'))) {
+    detected.add('cursor');
+  }
+  if (await exists(path.join(projectRoot, '.windsurf', 'rules', 'agent-flutter.md'))) {
+    detected.add('windsurf');
+  }
+  if (await exists(path.join(projectRoot, '.clinerules', 'agent-flutter.md'))) {
+    detected.add('cline');
+  }
+  if (
+    (await exists(path.join(projectRoot, '.github', 'copilot-instructions.md')))
+    || (await exists(path.join(projectRoot, '.github', 'skills')))
+  ) {
+    detected.add('github');
+  }
+  return detected;
 }
 
 async function runList(options) {
@@ -467,6 +592,19 @@ Execution checklist:
 `;
 }
 
+function buildGithubCopilotInstructions() {
+  return `# Agent Flutter Copilot Instructions
+
+This repository uses local instruction packs in \`.github/skills\` and \`.github/rules\`.
+
+Follow this order when generating code:
+1. Read applicable files in \`.github/rules/\`.
+2. If task matches a skill, read \`.github/skills/<skill>/SKILL.md\`.
+3. Keep architecture, localization, and UI conventions aligned with the shared pack.
+4. Update specs/docs when UI/API behavior changes.
+`;
+}
+
 async function exists(filePath) {
   try {
     await fs.access(filePath);