@solidactions/cli 1.5.0 → 1.6.0

package/README.md

@@ -12,7 +12,7 @@ npm install -g @solidactions/cli
 
 ```bash
 solidactions init <api-key>                          # Initialize (prompts for workspace)
-solidactions init <api-key> --workspace <name>       # Initialize with workspace
+solidactions ai init                                  # Install AI skills and SDK reference (required for AI-assisted dev)
 solidactions project deploy <project> <path>         # Deploy a project
 solidactions run start <project> <workflow>           # Trigger a workflow
 solidactions run view <run-id>                        # Inspect a run
@@ -127,16 +127,20 @@ Use `solidactions <command> --help` for full flag details on any command.
 
 | Command | Key Flags | Description |
 |---------|-----------|-------------|
-| `ai init` | `--claude`, `--agents`, `--no-skills` | Install AI helper docs |
+| `ai init` | `--claude`, `--agents` | Install AI skills and SDK reference |
 | `ai examples [names...]` | `--all`, `--overwrite` | Install example workflows |
 
-By default, `ai init` also installs three lazy-loaded SolidActions skills
-into `.claude/skills/`. These activate automatically when you scaffold a
-project, write workflow code, or deploy. The CLAUDE.md injection becomes
-a slim pointer to keep always-loaded context light.
-
-Pass `--no-skills` to skip the skill install and get the legacy full
-CLAUDE.md content instead.
+`ai init` installs three auto-activating SolidActions skills and a
+full SDK reference into your project:
+
+- Skills go to `.claude/skills/` (for `--claude` / Claude Code) or
+  `.agents/skills/` (for `--agents` / Codex, Cursor, Gemini, Windsurf).
+  Codex auto-discovers the `.agents/skills/` path — see
+  https://developers.openai.com/codex/skills.
+- The SDK reference is saved to `.solidactions/sdk-reference.md`.
+- A slim pointer section is injected into `CLAUDE.md` or `AGENTS.md`
+  listing the skills and inlining the highest-cost hard rules
+  (determinism, step discipline, messaging) as a safety net.
 
 ## Development
 

package/dist/commands/ai-init.js

@@ -14,7 +14,7 @@ const markers_1 = require("../utils/markers");
 const skills_1 = require("../utils/skills");
 async function aiInit(options = {}) {
     try {
-        // Determine target file
+        // Determine target file.
         let targetFile;
         if (options.claude && options.agents) {
             console.error(chalk_1.default.red('Please specify only one of --claude or --agents'));
@@ -32,8 +32,8 @@ async function aiInit(options = {}) {
                 name: 'file',
                 message: 'Which AI helper file?',
                 choices: [
-                    { title: 'CLAUDE.md', value: 'CLAUDE.md' },
-                    { title: 'AGENTS.md', value: 'AGENTS.md' },
+                    { title: 'CLAUDE.md (Claude Code)', value: 'CLAUDE.md' },
+                    { title: 'AGENTS.md (Codex, Cursor, Gemini, etc.)', value: 'AGENTS.md' },
                 ],
             });
             if (!response.file) {
@@ -42,58 +42,27 @@ async function aiInit(options = {}) {
             }
             targetFile = response.file;
         }
-        // Decide whether to install skills (default true; --no-skills opts out)
-        const installSkillsEnabled = options.skills !== false;
-        // Determine skill targets if installing.
-        // Skills are Claude Code-specific (.claude/skills/) and not meaningful for other AI tools.
-        let skillTargets = [];
-        if (installSkillsEnabled && targetFile === 'CLAUDE.md') {
-            skillTargets = (0, skills_1.detectSkillTargets)();
-            if (skillTargets.length === 0) {
-                const resp = await (0, prompts_1.default)({
-                    type: 'confirm',
-                    name: 'create',
-                    message: 'No `.claude/` directory found. Create `.claude/skills/` for SolidActions skills?',
-                    initial: true,
-                });
-                if (resp.create === undefined) {
-                    // User cancelled (Ctrl+C) — treat as abort, not decline
-                    console.log(chalk_1.default.yellow('Cancelled.'));
-                    process.exit(0);
-                }
-                else if (resp.create) {
-                    skillTargets = [path_1.default.join(process.cwd(), '.claude', 'skills')];
-                }
-                else {
-                    console.log(chalk_1.default.yellow('Skipping skill install. Run with --no-skills to silence this prompt.'));
-                }
-            }
-        }
         console.log(chalk_1.default.blue('Fetching AI helper content...'));
-        // Fetch CLAUDE.md content (slim pointer if skills installed, else full)
-        const aiContent = await (0, skills_1.fetchClaudeMdContent)(skillTargets.length > 0);
-        // Fetch SDK reference (always)
+        // Fetch slim helper content for the chosen target.
+        const aiContent = await (0, skills_1.fetchAiHelperContent)(targetFile);
+        // Fetch SDK reference (always).
         const sdkContent = await (0, github_1.fetchRawFile)('SolidActions', 'solidactions-ts-sdk', 'docs/sdk-reference.md');
-        // Save SDK reference to .solidactions/sdk-reference.md
+        // Save SDK reference to .solidactions/sdk-reference.md.
         fs_extra_1.default.ensureDirSync('.solidactions');
         fs_1.default.writeFileSync('.solidactions/sdk-reference.md', sdkContent, 'utf8');
         console.log(chalk_1.default.green('✓ SDK reference saved to .solidactions/sdk-reference.md'));
-        // Install skills if enabled and targets exist
-        if (skillTargets.length > 0) {
-            console.log(chalk_1.default.blue('Installing SolidActions skills...'));
-            const { written } = await (0, skills_1.installSkills)(skillTargets);
-            for (const f of written) {
-                console.log(chalk_1.default.green(`✓ ${path_1.default.relative(process.cwd(), f)}`));
-            }
+        // Always install skills — no prompt. The user chose `ai init <target>`,
+        // so they want AI tooling set up.
+        const targetDir = (0, skills_1.skillTargetDir)(targetFile);
+        console.log(chalk_1.default.blue(`Installing SolidActions skills to ${path_1.default.relative(process.cwd(), targetDir)}/ ...`));
+        const { written } = await (0, skills_1.installSkills)(targetDir);
+        for (const f of written) {
+            console.log(chalk_1.default.green(`✓ ${path_1.default.relative(process.cwd(), f)}`));
         }
-        // Upsert main AI helper section
+        // Upsert the AI helper marker section.
         (0, markers_1.upsertMarkerSection)(targetFile, 'SolidActions', aiContent);
-        // Upsert SDK reference pointer section
-        const sdkReferenceNote = `## SolidActions SDK Reference
-
-The full SDK API reference is available at \`.solidactions/sdk-reference.md\`. Refer to it for detailed function signatures, error classes, retry configuration, and advanced patterns like forking, streaming, and signal URLs.`;
-        (0, markers_1.upsertMarkerSection)(targetFile, 'SolidActions SDK Reference', sdkReferenceNote);
         console.log(chalk_1.default.green(`✓ AI helper installed to ${targetFile}`));
+        console.log(chalk_1.default.gray('  Existing files may still contain a separate "SolidActions SDK Reference" marker block from older CLI versions. That content is now redundant and can be deleted manually.'));
     }
     catch (error) {
         if (error.message?.includes('rate limit')) {

package/dist/commands/init.js

@@ -152,6 +152,9 @@ async function init(apiKey, options) {
         console.log(chalk_1.default.yellow('Could not set workspace. Run `solidactions workspace set` later.'));
     }
     console.log('');
+    console.log(chalk_1.default.blue('Next step — install AI helper docs and skills:'));
+    console.log(chalk_1.default.gray('  solidactions ai init                  Picks CLAUDE.md or AGENTS.md interactively'));
+    console.log('');
     console.log(chalk_1.default.blue('Quick start:'));
     console.log(chalk_1.default.gray('  solidactions project deploy <name>    Deploy current directory'));
     console.log(chalk_1.default.gray('  solidactions run start <proj> <wf>    Run a workflow'));

package/dist/index.js

@@ -311,10 +311,9 @@ workspace
 const ai = program.command('ai').description('AI helper tools');
 ai
     .command('init')
-    .description('Install AI helper documentation (CLAUDE.md or AGENTS.md) for AI-assisted workflow development')
+    .description('Install SolidActions AI skills and SDK reference for AI-assisted development')
     .option('--claude', 'Use CLAUDE.md (for Claude Code)')
-    .option('--agents', 'Use AGENTS.md (for Cursor, Windsurf, etc.)')
-    .option('--no-skills', 'Skip installing SolidActions skill files (uses legacy full CLAUDE.md injection)')
+    .option('--agents', 'Use AGENTS.md (for Codex, Cursor, Gemini, Windsurf, etc.)')
     .action((options) => { (0, ai_init_1.aiInit)(options); });
 ai
     .command('examples')

package/dist/utils/skills.js

@@ -3,9 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectSkillTargets = detectSkillTargets;
+exports.skillTargetDir = skillTargetDir;
 exports.installSkills = installSkills;
-exports.fetchClaudeMdContent = fetchClaudeMdContent;
+exports.fetchAiHelperContent = fetchAiHelperContent;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
@@ -19,53 +19,41 @@ const EXAMPLES_OWNER = 'SolidActions';
 const EXAMPLES_REPO = 'solidactions-examples';
 const SKILLS_PATH_PREFIX = 'skills';
 /**
- * Detect which AI-tool skill directories should receive skills.
- * Returns absolute paths to the target skills/ subdirectories.
+ * Resolve the skills directory for an AI helper target.
  *
- * v1 supports Claude Code only. Codex was resolved as user-global
- * (~/.codex/skills) with no project-local equivalent, so it is
- * intentionally NOT a target here.
+ * - `CLAUDE.md` → `<cwd>/.claude/skills/` (Claude Code convention)
+ * - `AGENTS.md` → `<cwd>/.agents/skills/` (Codex auto-discovers this path;
+ *   Cursor/Gemini read via AGENTS.md pointers)
  *
- * Detection rules:
- * - If `.claude/` exists in cwd → include `.claude/skills/`
- * - If neither exists → return empty (caller should prompt)
+ * The directory does not need to exist — the caller creates it.
  */
-function detectSkillTargets(cwd = process.cwd()) {
-    const targets = [];
-    if (fs_1.default.existsSync(path_1.default.join(cwd, '.claude'))) {
-        targets.push(path_1.default.join(cwd, '.claude', 'skills'));
+function skillTargetDir(targetFile, cwd = process.cwd()) {
+    if (targetFile === 'CLAUDE.md') {
+        return path_1.default.join(cwd, '.claude', 'skills');
     }
-    return targets;
+    return path_1.default.join(cwd, '.agents', 'skills');
 }
 /**
  * Fetch all SolidActions skill files from the examples repo and write
- * them into each target directory. Overwrites existing files (skills
+ * them into the target directory. Overwrites existing files (skills
  * are versioned upstream).
  */
-async function installSkills(targetDirs) {
+async function installSkills(targetDir) {
     const written = [];
-    for (const dir of targetDirs) {
-        fs_extra_1.default.ensureDirSync(dir);
-    }
+    fs_extra_1.default.ensureDirSync(targetDir);
     for (const skillName of SKILL_NAMES) {
         const remotePath = `${SKILLS_PATH_PREFIX}/${skillName}.md`;
         const content = await (0, github_1.fetchRawFile)(EXAMPLES_OWNER, EXAMPLES_REPO, remotePath);
-        for (const dir of targetDirs) {
-            const filePath = path_1.default.join(dir, `${skillName}.md`);
-            fs_1.default.writeFileSync(filePath, content, 'utf8');
-            written.push(filePath);
-        }
+        const filePath = path_1.default.join(targetDir, `${skillName}.md`);
+        fs_1.default.writeFileSync(filePath, content, 'utf8');
+        written.push(filePath);
     }
     return { written };
 }
 /**
- * Pick the right CLAUDE.md content variant from the examples repo
- * based on whether skills are being installed.
- *
- * - skillsInstalled = true  → fetches CLAUDE-skills-pointer.md (slim)
- * - skillsInstalled = false → fetches CLAUDE.md (full, legacy)
+ * Fetch the slim AI-helper content for the target file from the examples
+ * repo. Single source per target — no legacy fallback.
  */
-async function fetchClaudeMdContent(skillsInstalled) {
-    const file = skillsInstalled ? 'CLAUDE-skills-pointer.md' : 'CLAUDE.md';
-    return (0, github_1.fetchRawFile)(EXAMPLES_OWNER, EXAMPLES_REPO, file);
+async function fetchAiHelperContent(targetFile) {
+    return (0, github_1.fetchRawFile)(EXAMPLES_OWNER, EXAMPLES_REPO, targetFile);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@solidactions/cli",
-    "version": "1.5.0",
+    "version": "1.6.0",
     "description": "SolidActions CLI - Deploy and manage workflow automation",
     "main": "dist/index.js",
     "bin": {