ai-ide-config 0.1.0 → 0.1.2

package/README.md

@@ -1,117 +1,117 @@
-# ai-ide-config
-
-Scaffold shared Cursor IDE / agent setup into a project: shared `.cursor` rules/commands, plus stack-specific `AGENTS.md` and stack rules when needed.
-
-## Install / run
-
-No global install required:
-
-```bash
-npx ai-ide-config init
-```
-
-From a local checkout:
-
-```bash
-cd ai-ide-config
-npm link
-cd /path/to/your-project
-npx ai-ide-config init
-```
-
-## Usage
-
-```bash
-# Interactive: pick a stack
-npx ai-ide-config init
-
-# Non-interactive
-npx ai-ide-config init --stack angular
-npx ai-ide-config init-angular
-
-# Options
-npx ai-ide-config init --force        # overwrite existing files
-npx ai-ide-config init --dry-run      # preview only
-npx ai-ide-config init --skip-skills  # skip angular/skills install
-npx ai-ide-config init ./apps/web     # target directory
-```
-
-Existing template files are **skipped** unless you pass `--force`.
-
-`.gitignore` is handled specially:
-
-- If missing → create it with `.cursor/` and `.agents/`
-- If present → append `.cursor/` and/or `.agents/` only when missing
-
-If `package.json` exists, init pins an **exact** `packageManager` / `devEngines.packageManager` to the installed pnpm version. That avoids Corepack failing on ranges like `^11.13.0` from `pnpm init`.
-
-After scaffolding, the CLI runs:
-
-```bash
-pnpx skills add https://github.com/angular/skills
-```
-
-(`pnpx` is used instead of `npx` because the skills package requires pnpm via `devEngines`.)
-
-Use `--skip-skills` to skip that step. On `--dry-run`, the command is only printed.
-
-In CI or non-TTY shells, pass `--stack` (or use `init-<stack>`). Interactive prompts require a terminal.
-
-## What gets written
-
-| Path | Source |
-|------|--------|
-| `.cursor/rules/conventional-commits.mdc` | shared |
-| `.cursor/commands/generate-pr-description.md` | shared |
-| `.cursor/rules/angular-20.mdc` | angular ([angular.dev](https://angular.dev/assets/context/angular-20.mdc)) |
-| `AGENTS.md` | angular |
-| `pnpm-workspace.yaml` | angular (`blockExoticSubdeps`, `minimumReleaseAge: 4320`) |
-| `.gitignore` | create or append `.cursor/` and `.agents/` |
-
-After init, edit `AGENTS.md` placeholders (`<PROJECT_NAME>`, package manager, domains, paths) for the target repo.
-
-## Stacks
-
-| Id | Label |
-|----|-------|
-| `angular` | Angular |
-
-### Adding a stack
-
-1. Add `templates/<stack>/AGENTS.md`
-2. Register it in [`src/stacks.mjs`](src/stacks.mjs)
-3. Document it here
-
-Shared Cursor rules/commands stay under `templates/shared/`.
-
-## Publishing to npm
-
-CD publishes to npm when you create a **GitHub Release** (workflow: [`.github/workflows/publish.yml`](.github/workflows/publish.yml)).
-
-### One-time setup
-
-1. Create an [npmjs.com](https://www.npmjs.com) account and verify your email.
-2. Create the package on npm (first publish can also create it), or claim the name `ai-ide-config`.
-3. In the package settings on npm → **Trusted Publisher**:
-   - **Organization or user:** `iraldoad`
-   - **Repository:** `ai-ide-config`
-   - **Workflow filename:** `publish.yml`
-   - Allow **npm publish**
-4. No `NPM_TOKEN` secret is required (OIDC Trusted Publishing).
-
-### Release a version
-
-1. Bump `version` in `package.json` (e.g. `0.1.1`).
-2. Commit and push.
-3. Create a GitHub Release for that commit (e.g. tag `v0.1.1`).
-4. The workflow runs `npm publish --access public --provenance`.
-
-After the first successful publish:
-
-```bash
-npx ai-ide-config init
-```
-
-## License
-
-MIT
+# ai-ide-config
+
+Scaffold shared Cursor IDE / agent setup into a project: shared `.cursor` rules/commands, plus stack-specific `AGENTS.md` and stack rules when needed.
+
+## Install / run
+
+No global install required:
+
+```bash
+npx ai-ide-config init
+```
+
+From a local checkout:
+
+```bash
+cd ai-ide-config
+npm link
+cd /path/to/your-project
+npx ai-ide-config init
+```
+
+## Usage
+
+```bash
+# Interactive: pick a stack
+npx ai-ide-config init
+
+# Non-interactive
+npx ai-ide-config init --stack angular
+npx ai-ide-config init-angular
+
+# Options
+npx ai-ide-config init --force        # overwrite existing files
+npx ai-ide-config init --dry-run      # preview only
+npx ai-ide-config init --skip-skills  # skip midudev/autoskills install
+npx ai-ide-config init ./apps/web     # target directory
+```
+
+Existing template files are **skipped** unless you pass `--force`.
+
+`.gitignore` is handled specially:
+
+- If missing → create it with `.cursor/` and `.agents/`
+- If present → append `.cursor/` and/or `.agents/` only when missing
+
+If `package.json` exists, init pins an **exact** `packageManager` / `devEngines.packageManager` to the installed pnpm version. That avoids Corepack failing on ranges like `^11.13.0` from `pnpm init`.
+
+After scaffolding, the CLI runs:
+
+```bash
+pnpx skills add midudev/autoskills
+```
+
+(`pnpx` is used instead of `npx` because the skills package requires pnpm via `devEngines`.)
+
+Use `--skip-skills` to skip that step. On `--dry-run`, the command is only printed.
+
+In CI or non-TTY shells, pass `--stack` (or use `init-<stack>`). Interactive prompts require a terminal.
+
+## What gets written
+
+| Path | Source |
+|------|--------|
+| `.cursor/rules/conventional-commits.mdc` | shared |
+| `.cursor/commands/generate-pr-description.md` | shared |
+| `.cursor/rules/angular-20.mdc` | angular ([angular.dev](https://angular.dev/assets/context/angular-20.mdc)) |
+| `AGENTS.md` | angular |
+| `pnpm-workspace.yaml` | angular (`blockExoticSubdeps`, `minimumReleaseAge: 4320`) |
+| `.gitignore` | create or append `.cursor/` and `.agents/` |
+
+After init, edit `AGENTS.md` placeholders (`<PROJECT_NAME>`, package manager, domains, paths) for the target repo.
+
+## Stacks
+
+| Id | Label |
+|----|-------|
+| `angular` | Angular |
+
+### Adding a stack
+
+1. Add `templates/<stack>/AGENTS.md`
+2. Register it in [`src/stacks.mjs`](src/stacks.mjs)
+3. Document it here
+
+Shared Cursor rules/commands stay under `templates/shared/`.
+
+## Publishing to npm
+
+CD publishes to npm when you create a **GitHub Release** (workflow: [`.github/workflows/publish.yml`](.github/workflows/publish.yml)).
+
+### One-time setup
+
+1. Create an [npmjs.com](https://www.npmjs.com) account and verify your email.
+2. Create the package on npm (first publish can also create it), or claim the name `ai-ide-config`.
+3. In the package settings on npm → **Trusted Publisher**:
+   - **Organization or user:** `iraldoad`
+   - **Repository:** `ai-ide-config`
+   - **Workflow filename:** `publish.yml`
+   - Allow **npm publish**
+4. No `NPM_TOKEN` secret is required (OIDC Trusted Publishing).
+
+### Release a version
+
+1. Bump `version` in `package.json` (e.g. `0.1.1`).
+2. Commit and push.
+3. Create a GitHub Release for that commit (e.g. tag `v0.1.1`).
+4. The workflow runs `npm publish --access public --provenance`.
+
+After the first successful publish:
+
+```bash
+npx ai-ide-config init
+```
+
+## License
+
+MIT

package/bin/cli.mjs

@@ -1,186 +1,186 @@
-#!/usr/bin/env node
-
-import path from 'node:path';
-import { getStack, listStacks, stackIds } from '../src/stacks.mjs';
-import { promptForStack } from '../src/prompt.mjs';
-import { initStack, printReport } from '../src/init.mjs';
-import { runSkillsAdd, SKILLS_ADD_COMMAND } from '../src/skills.mjs';
-
-function printUsage() {
-  const stacks = listStacks()
-    .map((s) => `  init-${s.id}`.padEnd(18) + `# shortcut for init --stack ${s.id}`)
-    .join('\n');
-
-  console.log(`Usage:
-  ai-ide-config init [dir] [--stack <name>] [--force] [--dry-run] [--skip-skills]
-  ai-ide-config init-<stack> [dir] [--force] [--dry-run] [--skip-skills]
-
-Options:
-  --stack <name>   Skip interactive prompt (e.g. angular)
-  --force          Overwrite existing files
-  --dry-run        Show what would be written
-  --skip-skills    Do not run: ${SKILLS_ADD_COMMAND}
-
-Stacks:
-${listStacks()
-  .map((s) => `  ${s.id.padEnd(12)} ${s.label}`)
-  .join('\n')}
-
-Shortcuts:
-${stacks}
-`);
-}
-
-/**
- * @param {string[]} argv
- */
-function parseArgs(argv) {
-  const args = [...argv];
-  /** @type {{ command: string | null, targetDir: string, stackId: string | null, force: boolean, dryRun: boolean, skipSkills: boolean, help: boolean }} */
-  const result = {
-    command: null,
-    targetDir: process.cwd(),
-    stackId: null,
-    force: false,
-    dryRun: false,
-    skipSkills: false,
-    help: false,
-  };
-
-  const positionals = [];
-
-  while (args.length > 0) {
-    const token = args.shift();
-
-    if (token === '--help' || token === '-h') {
-      result.help = true;
-      continue;
-    }
-    if (token === '--force') {
-      result.force = true;
-      continue;
-    }
-    if (token === '--dry-run') {
-      result.dryRun = true;
-      continue;
-    }
-    if (token === '--skip-skills') {
-      result.skipSkills = true;
-      continue;
-    }
-    if (token === '--stack') {
-      const value = args.shift();
-      if (!value) {
-        throw new Error('--stack requires a value');
-      }
-      result.stackId = value;
-      continue;
-    }
-    if (token.startsWith('-')) {
-      throw new Error(`Unknown option: ${token}`);
-    }
-    positionals.push(token);
-  }
-
-  result.command = positionals[0] ?? null;
-  if (positionals[1]) {
-    result.targetDir = path.resolve(positionals[1]);
-  }
-
-  return result;
-}
-
-/**
- * Resolve stack id from command name like init-angular.
- * @param {string} command
- * @returns {string | null}
- */
-function stackFromInitAlias(command) {
-  const match = /^init-(.+)$/.exec(command);
-  if (!match) return null;
-  return match[1];
-}
-
-async function main() {
-  let parsed;
-  try {
-    parsed = parseArgs(process.argv.slice(2));
-  } catch (err) {
-    console.error(err.message);
-    printUsage();
-    process.exitCode = 1;
-    return;
-  }
-
-  if (parsed.help || !parsed.command) {
-    printUsage();
-    process.exitCode = parsed.help ? 0 : 1;
-    return;
-  }
-
-  let stackId = parsed.stackId;
-
-  if (parsed.command === 'init') {
-    // stackId may already be set via --stack
-  } else {
-    const aliasStack = stackFromInitAlias(parsed.command);
-    if (aliasStack) {
-      if (stackId && stackId !== aliasStack) {
-        console.error(
-          `Conflicting stacks: command is init-${aliasStack} but --stack ${stackId} was passed.`,
-        );
-        process.exitCode = 1;
-        return;
-      }
-      stackId = aliasStack;
-    } else {
-      console.error(`Unknown command: ${parsed.command}`);
-      printUsage();
-      process.exitCode = 1;
-      return;
-    }
-  }
-
-  if (!stackId) {
-    try {
-      stackId = await promptForStack();
-    } catch (err) {
-      console.error(err.message);
-      process.exitCode = 1;
-      return;
-    }
-  }
-
-  const stack = getStack(stackId);
-  if (!stack) {
-    console.error(
-      `Unknown stack "${stackId}". Available: ${stackIds().join(', ')}`,
-    );
-    process.exitCode = 1;
-    return;
-  }
-
-  try {
-    const report = initStack({
-      stack,
-      targetDir: parsed.targetDir,
-      force: parsed.force,
-      dryRun: parsed.dryRun,
-    });
-
-    console.log(
-      `${parsed.dryRun ? '[dry-run] ' : ''}Scaffolding ${stack.label} AI IDE config into ${parsed.targetDir}`,
-    );
-    printReport(report, { dryRun: parsed.dryRun });
-
-    runSkillsAdd(parsed.targetDir, {
-      dryRun: parsed.dryRun,
-      skip: parsed.skipSkills,
-    });
-  } catch (err) {
-    console.error(err.message);
-    process.exitCode = 1;
-  }
-}
-
-main();
+#!/usr/bin/env node
+
+import path from 'node:path';
+import { getStack, listStacks, stackIds } from '../src/stacks.mjs';
+import { promptForStack } from '../src/prompt.mjs';
+import { initStack, printReport } from '../src/init.mjs';
+import { runSkillsAdd, SKILLS_ADD_COMMAND } from '../src/skills.mjs';
+
+function printUsage() {
+  const stacks = listStacks()
+    .map((s) => `  init-${s.id}`.padEnd(18) + `# shortcut for init --stack ${s.id}`)
+    .join('\n');
+
+  console.log(`Usage:
+  ai-ide-config init [dir] [--stack <name>] [--force] [--dry-run] [--skip-skills]
+  ai-ide-config init-<stack> [dir] [--force] [--dry-run] [--skip-skills]
+
+Options:
+  --stack <name>   Skip interactive prompt (e.g. angular)
+  --force          Overwrite existing files
+  --dry-run        Show what would be written
+  --skip-skills    Do not run: ${SKILLS_ADD_COMMAND}
+
+Stacks:
+${listStacks()
+  .map((s) => `  ${s.id.padEnd(12)} ${s.label}`)
+  .join('\n')}
+
+Shortcuts:
+${stacks}
+`);
+}
+
+/**
+ * @param {string[]} argv
+ */
+function parseArgs(argv) {
+  const args = [...argv];
+  /** @type {{ command: string | null, targetDir: string, stackId: string | null, force: boolean, dryRun: boolean, skipSkills: boolean, help: boolean }} */
+  const result = {
+    command: null,
+    targetDir: process.cwd(),
+    stackId: null,
+    force: false,
+    dryRun: false,
+    skipSkills: false,
+    help: false,
+  };
+
+  const positionals = [];
+
+  while (args.length > 0) {
+    const token = args.shift();
+
+    if (token === '--help' || token === '-h') {
+      result.help = true;
+      continue;
+    }
+    if (token === '--force') {
+      result.force = true;
+      continue;
+    }
+    if (token === '--dry-run') {
+      result.dryRun = true;
+      continue;
+    }
+    if (token === '--skip-skills') {
+      result.skipSkills = true;
+      continue;
+    }
+    if (token === '--stack') {
+      const value = args.shift();
+      if (!value) {
+        throw new Error('--stack requires a value');
+      }
+      result.stackId = value;
+      continue;
+    }
+    if (token.startsWith('-')) {
+      throw new Error(`Unknown option: ${token}`);
+    }
+    positionals.push(token);
+  }
+
+  result.command = positionals[0] ?? null;
+  if (positionals[1]) {
+    result.targetDir = path.resolve(positionals[1]);
+  }
+
+  return result;
+}
+
+/**
+ * Resolve stack id from command name like init-angular.
+ * @param {string} command
+ * @returns {string | null}
+ */
+function stackFromInitAlias(command) {
+  const match = /^init-(.+)$/.exec(command);
+  if (!match) return null;
+  return match[1];
+}
+
+async function main() {
+  let parsed;
+  try {
+    parsed = parseArgs(process.argv.slice(2));
+  } catch (err) {
+    console.error(err.message);
+    printUsage();
+    process.exitCode = 1;
+    return;
+  }
+
+  if (parsed.help || !parsed.command) {
+    printUsage();
+    process.exitCode = parsed.help ? 0 : 1;
+    return;
+  }
+
+  let stackId = parsed.stackId;
+
+  if (parsed.command === 'init') {
+    // stackId may already be set via --stack
+  } else {
+    const aliasStack = stackFromInitAlias(parsed.command);
+    if (aliasStack) {
+      if (stackId && stackId !== aliasStack) {
+        console.error(
+          `Conflicting stacks: command is init-${aliasStack} but --stack ${stackId} was passed.`,
+        );
+        process.exitCode = 1;
+        return;
+      }
+      stackId = aliasStack;
+    } else {
+      console.error(`Unknown command: ${parsed.command}`);
+      printUsage();
+      process.exitCode = 1;
+      return;
+    }
+  }
+
+  if (!stackId) {
+    try {
+      stackId = await promptForStack();
+    } catch (err) {
+      console.error(err.message);
+      process.exitCode = 1;
+      return;
+    }
+  }
+
+  const stack = getStack(stackId);
+  if (!stack) {
+    console.error(
+      `Unknown stack "${stackId}". Available: ${stackIds().join(', ')}`,
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  try {
+    const report = initStack({
+      stack,
+      targetDir: parsed.targetDir,
+      force: parsed.force,
+      dryRun: parsed.dryRun,
+    });
+
+    console.log(
+      `${parsed.dryRun ? '[dry-run] ' : ''}Scaffolding ${stack.label} AI IDE config into ${parsed.targetDir}`,
+    );
+    printReport(report, { dryRun: parsed.dryRun });
+
+    runSkillsAdd(parsed.targetDir, {
+      dryRun: parsed.dryRun,
+      skip: parsed.skipSkills,
+    });
+  } catch (err) {
+    console.error(err.message);
+    process.exitCode = 1;
+  }
+}
+
+main();

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "ai-ide-config",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Scaffold shared Cursor IDE / agent config (rules, commands, stack AGENTS.md)",
   "type": "module",
   "bin": {
-    "ai-ide-config": "./bin/cli.mjs"
+    "ai-ide-config": "bin/cli.mjs"
   },
   "files": [
     "bin",
@@ -31,4 +31,4 @@
     "angular"
   ],
   "license": "MIT"
-}
+}