@solidactions/cli 1.3.0 → 1.5.0

package/README.md

@@ -127,9 +127,17 @@ Use `solidactions <command> --help` for full flag details on any command.
 
 | Command | Key Flags | Description |
 |---------|-----------|-------------|
-| `ai init` | `--claude`, `--agents` | Install AI helper docs |
+| `ai init` | `--claude`, `--agents`, `--no-skills` | Install AI helper docs |
 | `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.
+
 ## Development
 
 ```bash

package/dist/commands/ai-init.js

@@ -8,8 +8,10 @@ const fs_1 = __importDefault(require("fs"));
 const chalk_1 = __importDefault(require("chalk"));
 const prompts_1 = __importDefault(require("prompts"));
 const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
 const github_1 = require("../utils/github");
 const markers_1 = require("../utils/markers");
+const skills_1 = require("../utils/skills");
 async function aiInit(options = {}) {
     try {
         // Determine target file
@@ -40,15 +42,50 @@ 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 AI helper content from examples repo
-        const aiContent = await (0, github_1.fetchRawFile)('SolidActions', 'solidactions-examples', 'CLAUDE.md');
-        // Fetch SDK reference
+        // 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)
         const sdkContent = await (0, github_1.fetchRawFile)('SolidActions', 'solidactions-ts-sdk', 'docs/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)}`));
+            }
+        }
         // Upsert main AI helper section
         (0, markers_1.upsertMarkerSection)(targetFile, 'SolidActions', aiContent);
         // Upsert SDK reference pointer section

package/dist/commands/deploy.js

@@ -114,11 +114,51 @@ async function pushYamlDeclarations(config, projectSlug, yamlConfig) {
 async function deploy(projectName, sourcePath, options = {}) {
     const config = await (0, api_1.requireConfigWithWorkspace)();
     const sourceDir = sourcePath ? path_1.default.resolve(sourcePath) : process.cwd();
-    const environment = options.env || 'dev';
+    // Capture whether -e was explicitly passed by the caller. Commander leaves
+    // options.env as undefined when no default is set and the flag is omitted.
+    const explicitEnv = options.env;
     if (!fs_1.default.existsSync(sourceDir)) {
         console.error(chalk_1.default.red(`Source directory not found: ${sourceDir}`));
         process.exit(1);
     }
+    // -------------------------------------------------------------------------
+    // Production-existence check — must happen BEFORE we apply any env default
+    // so that first-time deploys without -e get a helpful error instead of
+    // silently creating a dev-only project with no production root.
+    // -------------------------------------------------------------------------
+    let productionExists = null; // null = unknown (error path)
+    let productionSlug = null;
+    try {
+        const prodResponse = await axios_1.default.get(`${config.host}/api/v1/projects/${projectName}`, {
+            headers: (0, api_1.getApiHeaders)(config),
+        });
+        productionExists = true;
+        productionSlug = prodResponse.data.slug || prodResponse.data.name;
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            productionExists = false;
+        }
+        else {
+            // 5xx, network error, auth failure, etc. — fail conservatively rather
+            // than treating the project as non-existent and potentially creating it.
+            console.error(chalk_1.default.red('Failed to check project existence:'), error.response?.data?.message || error.message);
+            process.exit(1);
+        }
+    }
+    // Decision: if production does not exist and no -e flag was given, the user
+    // must pick an environment explicitly to avoid creating a broken dev-only project.
+    if (productionExists === false && explicitEnv === undefined) {
+        console.error(chalk_1.default.red(`\nThis is the first deploy of "${projectName}" — please pick an environment explicitly:\n`));
+        console.error(`  solidactions project deploy ${projectName} <path> -e production    # most projects start here`);
+        console.error(`  solidactions project deploy ${projectName} <path> -e dev            # dev-only (uncommon; no production root will exist)`);
+        console.error(`  solidactions project deploy ${projectName} <path> -e staging        # staging-only (uncommon)`);
+        console.error(chalk_1.default.gray('\nTip: most projects should start with `-e production`. A project needs a production root before dev/staging children can attach to it.'));
+        process.exit(1);
+    }
+    // Apply default: if production already exists and the user didn't pass -e,
+    // use 'dev' — this preserves existing behavior for mature projects.
+    const environment = explicitEnv ?? 'dev';
     const envLabel = environment !== 'production' ? ` (${environment})` : '';
     console.log(chalk_1.default.blue(`Deploying to project "${projectName}"${envLabel}...`));
     console.log(chalk_1.default.gray(`Source: ${sourceDir}`));
@@ -149,24 +189,36 @@ async function deploy(projectName, sourcePath, options = {}) {
         process.exit(1);
     }
     console.log(chalk_1.default.green('✓ Project structure validated'));
-    // Check if project exists, create if not
+    // Check if the target environment's project record exists; create if needed.
+    // For production deploys where we already confirmed existence above, reuse
+    // the cached slug to avoid a duplicate GET.
     let projectSlug = projectName;
     try {
-        // For non-production environments, append the environment to the slug for lookup
-        const lookupSlug = environment === 'production'
-            ? projectName
-            : `${projectName}-${environment}`;
-        const checkResponse = await axios_1.default.get(`${config.host}/api/v1/projects/${lookupSlug}`, {
-            headers: (0, api_1.getApiHeaders)(config),
-        });
-        projectSlug = checkResponse.data.slug || checkResponse.data.name;
+        if (environment === 'production' && productionExists === true && productionSlug !== null) {
+            // Already confirmed — skip the re-lookup.
+            projectSlug = productionSlug;
+        }
+        else {
+            // For non-production environments, append the environment to the slug for lookup
+            const lookupSlug = environment === 'production'
+                ? projectName
+                : `${projectName}-${environment}`;
+            const checkResponse = await axios_1.default.get(`${config.host}/api/v1/projects/${lookupSlug}`, {
+                headers: (0, api_1.getApiHeaders)(config),
+            });
+            projectSlug = checkResponse.data.slug || checkResponse.data.name;
+        }
     }
     catch (error) {
         if (error.response?.status === 404) {
-            // For non-production environments, check if we should create
+            // For non-production environments, require --create or give a clear hint
             if (environment !== 'production' && !options.create) {
-                console.log(chalk_1.default.yellow(`Project "${projectName}" doesn't have a ${environment} environment.`));
-                console.log(chalk_1.default.gray('Use --create to create it, or deploy to production first.'));
+                console.error(chalk_1.default.red(`\nProject "${projectName}" doesn't have a ${environment} environment.\n`));
+                console.error(`  If production is the intended target:`);
+                console.error(`    solidactions project deploy ${projectName} <path> -e production`);
+                console.error('');
+                console.error(`  If you really want a new ${environment} environment:`);
+                console.error(`    solidactions project deploy ${projectName} <path> -e ${environment} --create`);
                 process.exit(1);
             }
             console.log(chalk_1.default.yellow(`Project "${projectName}"${envLabel} not found. Creating...`));

package/dist/index.js

@@ -104,7 +104,7 @@ project
     .description('Deploy a project to SolidActions')
     .argument('<project-name>', 'Project name (will be created if it doesn\'t exist)')
     .argument('[path]', 'Source directory to deploy (defaults to current directory)')
-    .option('-e, --env <environment>', 'Target environment (production/staging/dev)', 'dev')
+    .option('-e, --env <environment>', 'Target environment (production/staging/dev). Required on first deploy of a new project.')
     .option('--create', 'Create environment project if it doesn\'t exist')
     .option('--config-only', 'Sync YAML env declarations without building/deploying')
     .action((projectName, path, options) => {
@@ -314,6 +314,7 @@ ai
     .description('Install AI helper documentation (CLAUDE.md or AGENTS.md) for AI-assisted workflow 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)')
     .action((options) => { (0, ai_init_1.aiInit)(options); });
 ai
     .command('examples')

package/dist/utils/skills.js

@@ -0,0 +1,71 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectSkillTargets = detectSkillTargets;
+exports.installSkills = installSkills;
+exports.fetchClaudeMdContent = fetchClaudeMdContent;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const github_1 = require("./github");
+const SKILL_NAMES = [
+    'solidactions-getting-started',
+    'solidactions-workflow-coding',
+    'solidactions-deploy-and-config',
+];
+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.
+ *
+ * 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.
+ *
+ * Detection rules:
+ * - If `.claude/` exists in cwd → include `.claude/skills/`
+ * - If neither exists → return empty (caller should prompt)
+ */
+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'));
+    }
+    return targets;
+}
+/**
+ * Fetch all SolidActions skill files from the examples repo and write
+ * them into each target directory. Overwrites existing files (skills
+ * are versioned upstream).
+ */
+async function installSkills(targetDirs) {
+    const written = [];
+    for (const dir of targetDirs) {
+        fs_extra_1.default.ensureDirSync(dir);
+    }
+    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);
+        }
+    }
+    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)
+ */
+async function fetchClaudeMdContent(skillsInstalled) {
+    const file = skillsInstalled ? 'CLAUDE-skills-pointer.md' : 'CLAUDE.md';
+    return (0, github_1.fetchRawFile)(EXAMPLES_OWNER, EXAMPLES_REPO, file);
+}

package/package.json

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