@moda-ai/cli 1.22.1 → 1.23.0

package/dist/skills-manifest.js

@@ -1,244 +0,0 @@
-// src/skills-manifest.ts — the .moda/skills.yml install manifest.
-//
-// The manifest records every skill file Moda manages inside a user's repo so
-// that (a) `skills sync` never pushes Moda-managed files back up, and (b) a
-// harness release change prunes exactly the files the previous release wrote.
-// Two producers write records here: `skills pull` (harness-generated skills,
-// source 'moda') and the bundled integration-skill installer
-// (src/skills-bundled.ts, source 'integration-bundled').
-//
-// IMPORTANT: the YAML here is hand-rolled on both sides — writeSkillsManifest
-// emits a fixed 2/4/6-space layout and readSkillRecords/readManagedPaths parse
-// exactly that layout. Keep reader and writer in lockstep; they live in this
-// module together so a format change cannot land on one side only.
-import { existsSync, mkdirSync, readdirSync, readFileSync, rmdirSync, unlinkSync, writeFileSync, } from 'node:fs';
-import { dirname, isAbsolute, join, normalize, relative, resolve } from 'node:path';
-export const SKILLS_MANIFEST_PATH = join('.moda', 'skills.yml');
-// Per-record `source` values. Harness-generated skills (pulled from the
-// tenant store) keep the legacy value 'moda'; skills materialized from the
-// CLI's bundled integration set use 'integration-bundled'. Pruning on a
-// release change is scoped to harness records only, and `skills sync`
-// excludes every managed path regardless of source.
-export const SKILL_SOURCE_HARNESS = 'moda';
-export const SKILL_SOURCE_INTEGRATION_BUNDLED = 'integration-bundled';
-export function readSkillsManifest(cwd) {
-    const manifestPath = join(cwd, SKILLS_MANIFEST_PATH);
-    if (!existsSync(manifestPath))
-        return null;
-    let text = '';
-    try {
-        text = readFileSync(manifestPath, 'utf8');
-    }
-    catch {
-        return null;
-    }
-    return {
-        tenantId: readYamlScalar(text, 'tenant_id'),
-        generationRunId: readYamlScalar(text, 'generation_run_id'),
-        generationVersion: Number(readYamlScalar(text, 'generation_version') || 0),
-        releaseKey: readYamlScalar(text, 'release_key'),
-        statusFilter: readYamlScalar(text, 'status_filter'),
-        releasedAt: readYamlScalar(text, 'released_at'),
-        managedPaths: readManagedPaths(text),
-        records: readSkillRecords(text),
-    };
-}
-export function manifestHeaderFrom(manifest) {
-    return {
-        tenantId: manifest?.tenantId ?? '',
-        releaseKey: manifest?.releaseKey ?? '',
-        statusFilter: manifest?.statusFilter ?? '',
-        generationRunId: manifest?.generationRunId ?? '',
-        generationVersion: manifest?.generationVersion ?? 0,
-        releasedAt: manifest?.releasedAt ?? '',
-    };
-}
-export function writeSkillsManifest(cwd, header, records) {
-    const manifestPath = join(cwd, SKILLS_MANIFEST_PATH);
-    const managedPaths = [...new Set(records.flatMap((record) => record.paths))].sort();
-    const lines = [
-        'version: 1',
-        'source: moda',
-        `tenant_id: ${yamlQuote(header.tenantId)}`,
-        `release_key: ${yamlQuote(header.releaseKey)}`,
-        `status_filter: ${yamlQuote(header.statusFilter)}`,
-        `generation_run_id: ${yamlQuote(header.generationRunId)}`,
-        `generation_version: ${header.generationVersion}`,
-        `released_at: ${yamlQuote(header.releasedAt)}`,
-        `installed_at: ${yamlQuote(new Date().toISOString())}`,
-        'managed_paths:',
-        ...managedPaths.map((path) => `  - ${yamlQuote(path)}`),
-        'skills:',
-        ...records.flatMap((record) => [
-            `  - skill_id: ${yamlQuote(record.skillId)}`,
-            `    content_hash: ${yamlQuote(record.contentHash)}`,
-            `    source: ${yamlQuote(record.source)}`,
-            '    paths:',
-            ...record.paths.map((path) => `      - ${yamlQuote(path)}`),
-        ]),
-        '',
-    ];
-    mkdirSync(dirname(manifestPath), { recursive: true });
-    writeFileSync(manifestPath, lines.join('\n'));
-}
-/**
- * Upsert a skill record into .moda/skills.yml, preserving the harness release
- * header and all other records. Used by the bundled integration-skill
- * installer so its materialized files become managed paths (excluded from
- * `skills sync`, never pruned by harness release changes).
- */
-export function upsertSkillManifestRecord(cwd, record) {
-    const manifest = readSkillsManifest(cwd);
-    const records = (manifest?.records ?? []).filter((existing) => !(existing.skillId === record.skillId && existing.source === record.source));
-    records.push(record);
-    writeSkillsManifest(cwd, manifestHeaderFrom(manifest), records);
-}
-export function pruneManagedSkillPaths(cwd, managedPaths, log) {
-    let pruned = 0;
-    for (const rawPath of [...new Set(managedPaths)]) {
-        const safePath = safeManagedRelativePath(rawPath);
-        if (!safePath)
-            continue;
-        const absolutePath = absoluteManagedPath(cwd, safePath);
-        if (!absolutePath || !existsSync(absolutePath))
-            continue;
-        try {
-            unlinkSync(absolutePath);
-            pruned++;
-            log(`  pruned ${safePath}`);
-            pruneEmptyClaudeSkillDir(cwd, safePath);
-        }
-        catch {
-            // Best-effort cleanup. The following write pass can still repair files
-            // that remain writable.
-        }
-    }
-    return pruned;
-}
-function pruneEmptyClaudeSkillDir(cwd, relativePath) {
-    if (!relativePath.startsWith('.claude/skills/') || !relativePath.endsWith('/SKILL.md'))
-        return;
-    const dir = dirname(join(cwd, relativePath));
-    try {
-        if (existsSync(dir) && readdirSync(dir).length === 0) {
-            rmdirSync(dir);
-        }
-    }
-    catch {
-        // Empty-dir pruning is only cosmetic.
-    }
-}
-function absoluteManagedPath(cwd, relativePath) {
-    const abs = resolve(cwd, relativePath);
-    const root = resolve(cwd);
-    const rel = relative(root, abs);
-    if (rel.startsWith('..') || isAbsolute(rel))
-        return null;
-    return abs;
-}
-function safeManagedRelativePath(rawPath) {
-    if (!rawPath || rawPath.includes('\0') || isAbsolute(rawPath))
-        return null;
-    const normalized = normalize(rawPath).replace(/\\/g, '/');
-    if (normalized.startsWith('../') || normalized === '..' || normalized.includes('/../'))
-        return null;
-    const isClaudeSkill = normalized.startsWith('.claude/skills/') && normalized.endsWith('/SKILL.md');
-    const isCursorRule = normalized.startsWith('.cursor/rules/') && normalized.endsWith('.mdc');
-    return isClaudeSkill || isCursorRule ? normalized : null;
-}
-function readYamlScalar(text, key) {
-    const match = text.match(new RegExp(`^${key}:\\s*(.*?)\\s*$`, 'm'));
-    return match ? parseYamlScalar(match[1]) : '';
-}
-/** Parse the `skills:` record list from the hand-rolled manifest YAML. */
-function readSkillRecords(text) {
-    const records = [];
-    let inSkills = false;
-    let current = null;
-    let inPaths = false;
-    for (const line of text.split(/\r?\n/)) {
-        if (line.trim() === 'skills:') {
-            inSkills = true;
-            continue;
-        }
-        if (!inSkills)
-            continue;
-        if (line.length > 0 && !line.startsWith(' '))
-            break;
-        const skillIdMatch = line.match(/^ {2}- skill_id:\s*(.*?)\s*$/);
-        if (skillIdMatch) {
-            if (current)
-                records.push(current);
-            current = {
-                skillId: parseYamlScalar(skillIdMatch[1]),
-                contentHash: '',
-                // Legacy manifests predate per-record sources; they were all pulls.
-                source: SKILL_SOURCE_HARNESS,
-                paths: [],
-            };
-            inPaths = false;
-            continue;
-        }
-        if (!current)
-            continue;
-        const hashMatch = line.match(/^ {4}content_hash:\s*(.*?)\s*$/);
-        if (hashMatch) {
-            current.contentHash = parseYamlScalar(hashMatch[1]);
-            continue;
-        }
-        const sourceMatch = line.match(/^ {4}source:\s*(.*?)\s*$/);
-        if (sourceMatch) {
-            current.source = parseYamlScalar(sourceMatch[1]) || SKILL_SOURCE_HARNESS;
-            continue;
-        }
-        if (/^ {4}paths:\s*$/.test(line)) {
-            inPaths = true;
-            continue;
-        }
-        const pathMatch = inPaths ? line.match(/^ {6}-\s*(.*?)\s*$/) : null;
-        if (pathMatch) {
-            const value = parseYamlScalar(pathMatch[1]);
-            if (value)
-                current.paths.push(value);
-        }
-    }
-    if (current)
-        records.push(current);
-    return records;
-}
-function readManagedPaths(text) {
-    const paths = [];
-    let inManagedPaths = false;
-    for (const line of text.split(/\r?\n/)) {
-        if (line.trim() === 'managed_paths:') {
-            inManagedPaths = true;
-            continue;
-        }
-        if (inManagedPaths && line.length > 0 && !line.startsWith(' '))
-            break;
-        if (!inManagedPaths)
-            continue;
-        const match = line.match(/^\s*-\s*(.*?)\s*$/);
-        if (match)
-            paths.push(parseYamlScalar(match[1]));
-    }
-    return paths.filter(Boolean);
-}
-function parseYamlScalar(raw) {
-    const value = raw.trim();
-    if (!value)
-        return '';
-    if (value.startsWith('"')) {
-        try {
-            return String(JSON.parse(value));
-        }
-        catch {
-            return value.replace(/^"|"$/g, '');
-        }
-    }
-    return value.replace(/^'|'$/g, '');
-}
-function yamlQuote(value) {
-    return JSON.stringify(value);
-}
-//# sourceMappingURL=skills-manifest.js.map

package/dist/skills.d.ts

@@ -1,57 +0,0 @@
-import { type CommandContext } from './command-context.js';
-import type { ProfileIOOptions } from './profiles.js';
-interface PullSummary {
-    total: number;
-    pruned: number;
-    wrote: number;
-    updated: number;
-    unchanged: number;
-    failed: number;
-}
-/**
- * Pull generated skills into the detected coding agents' skill directories.
- * Exported so `moda init` can run it as a setup step. Best-effort and quiet on
- * an empty store; never throws for "no skills yet".
- */
-export declare function pullSkills(options?: {
-    status?: string;
-    cwd?: string;
-    silent?: boolean;
-}): Promise<PullSummary>;
-export interface SkillSyncResult {
-    synced: Array<{
-        key: string;
-        skillId?: string;
-        versionId?: string;
-        version?: number;
-        contentHash: string;
-        changed?: boolean;
-        sourcePath?: string;
-    }>;
-    dryRun: boolean;
-}
-/**
- * Push locally-authored `.claude/skills/**\/SKILL.md` files up to Moda via
- * `POST /api/skills/sync`. Modeled on `runPromptSync`: returns the synced list
- * without printing so callers (e.g. `moda init`) control their own output.
- * `moda skills sync` wraps this with JSON output.
- *
- * Skills that Moda itself manages — those previously pulled/generated (tracked
- * in `.moda/skills.yml`) and the shipped `moda-cli` skill — are excluded so we
- * only push skills the user authored.
- */
-export declare function runSkillSync(flags?: Record<string, string>, profileOptions?: ProfileIOOptions, options?: {
-    cwd?: string;
-}): Promise<SkillSyncResult>;
-/**
- * `moda skills <subcommand>` dispatcher.
- */
-type LegacySkillsArgs = {
-    command: string;
-    positional: string | undefined;
-    positionals: string[];
-    flags: Record<string, string>;
-};
-export declare function runSkillsCommand(input: CommandContext | LegacySkillsArgs): Promise<number>;
-export {};
-//# sourceMappingURL=skills.d.ts.map