agent-flutter 0.1.1 → 0.1.2

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
 ```
 
@@ -55,3 +58,4 @@ npm run release:major
 - Cursor: `.cursor/rules/agent-flutter.mdc`
 - Windsurf: `.windsurf/rules/agent-flutter.md`
 - Cline: `.clinerules/agent-flutter.md`
+- GitHub: `.github/copilot-instructions.md`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-flutter",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "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,6 +87,61 @@ async function runInit(options) {
   const ideTargets = resolveIdeTargets(options.get('ide', 'all'));
   const force = options.hasFlag('force');
 
+  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 {
+    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 sharedTarget = path.join(projectRoot, '.agent-flutter');
   if ((await exists(sharedTarget)) && !force) {
     console.log(`Using existing shared pack: ${sharedTarget}`);
@@ -92,7 +152,7 @@ async function runInit(options) {
       projectRoot,
       force: true,
     });
-    console.log(`Installed shared pack: ${sharedTarget}`);
+    console.log(`${verb} shared pack: ${sharedTarget}`);
   }
 
   if (ideTargets.has('trae')) {
@@ -106,7 +166,7 @@ async function runInit(options) {
         projectRoot,
         force: true,
       });
-      console.log(`Installed Trae adapter: ${traeTarget}`);
+      console.log(`${verb} Trae adapter: ${traeTarget}`);
     }
   }
 
@@ -127,7 +187,7 @@ async function runInit(options) {
     );
     console.log(
       written
-        ? `Installed Codex adapter: ${agentsPath}`
+        ? `${verb} Codex adapter: ${agentsPath}`
         : `Skipped Codex adapter (exists): ${agentsPath}`,
     );
   }
@@ -141,7 +201,7 @@ async function runInit(options) {
     );
     console.log(
       written
-        ? `Installed Cursor adapter: ${cursorPath}`
+        ? `${verb} Cursor adapter: ${cursorPath}`
         : `Skipped Cursor adapter (exists): ${cursorPath}`,
     );
   }
@@ -155,7 +215,7 @@ async function runInit(options) {
     );
     console.log(
       written
-        ? `Installed Windsurf adapter: ${windsurfPath}`
+        ? `${verb} Windsurf adapter: ${windsurfPath}`
         : `Skipped Windsurf adapter (exists): ${windsurfPath}`,
     );
   }
@@ -169,14 +229,45 @@ 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 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 checks = [
+    ['trae', path.join(projectRoot, '.trae')],
+    ['codex', path.join(projectRoot, 'AGENTS.md')],
+    ['cursor', path.join(projectRoot, '.cursor', 'rules', 'agent-flutter.mdc')],
+    ['windsurf', path.join(projectRoot, '.windsurf', 'rules', 'agent-flutter.md')],
+    ['cline', path.join(projectRoot, '.clinerules', 'agent-flutter.md')],
+    ['github', path.join(projectRoot, '.github', 'copilot-instructions.md')],
+  ];
+
+  const results = await Promise.all(
+    checks.map(async ([ide, targetPath]) => [ide, await exists(targetPath)]),
+  );
+
+  const detected = new Set();
+  for (const [ide, installed] of results) {
+    if (installed) detected.add(ide);
+  }
+  return detected;
 }
 
 async function runList(options) {
@@ -467,6 +558,19 @@ Execution checklist:
 `;
 }
 
+function buildGithubCopilotInstructions() {
+  return `# Agent Flutter Copilot Instructions
+
+This repository uses a shared local instruction pack in \`.agent-flutter\`.
+
+Follow this order when generating code:
+1. Read applicable files in \`.agent-flutter/rules/\`.
+2. If task matches a skill, read \`.agent-flutter/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);