@chenmk/superflow 0.1.3 → 0.2.1

package/dist/app/cli.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { cliText, resolveCliLanguage } from '../domains/config/cli-help.js';
+import { checkForUpdates } from '../platform/version-check.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkgPath = join(__dirname, '..', '..', 'package.json');
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+// 启动时后台检查新版本（非阻塞，不 await）
+checkForUpdates(pkg.version);
+const program = new Command();
+const helpText = cliText(resolveCliLanguage());
+function resolveTargetPathArg(value, command, commandName) {
+    if (typeof value === 'string' && value.length > 0 && value !== '.')
+        return value;
+    const args = command?.args;
+    const first = args?.[0];
+    if (typeof first === 'string' && first.length > 0)
+        return first;
+    const index = process.argv.indexOf(commandName);
+    if (index >= 0) {
+        const valueOptions = new Set([
+            '--agent',
+            '--scope',
+        ]);
+        for (let i = index + 1; i < process.argv.length; i++) {
+            const arg = process.argv[i];
+            if (valueOptions.has(arg)) {
+                i++;
+                continue;
+            }
+            if (!arg.startsWith('-'))
+                return arg;
+        }
+    }
+    return '.';
+}
+function commandOptions(options) {
+    const opts = options?.opts;
+    return {
+        ...program.opts(),
+        ...(typeof opts === 'function' ? opts.call(options) : { ...options }),
+    };
+}
+program
+    .name('superflow')
+    .description(helpText.programDescription)
+    .option('--language <language>', helpText.languageOption)
+    .option('--lang <language>', helpText.languageOption)
+    .version(pkg.version);
+program
+    .command('init [targetPath]')
+    .description(helpText.initDescription)
+    .option('--dry-run', helpText.dryRun)
+    .option('--agent <agent>', helpText.agentOption)
+    .option('--scope <scope>', helpText.scopeOption, 'global')
+    .option('--language <language>', helpText.languageOption)
+    .option('--yes', helpText.yesOption)
+    .option('--json', helpText.jsonOption)
+    .option('--resume', helpText.resumeOption)
+    .option('--skip-existing', helpText.skipExistingOption)
+    .option('--overwrite', helpText.overwriteOption)
+    .option('--no-hooks', helpText.noHooksOption)
+    .option('--no-openspec-init', helpText.noOpenspecInitOption)
+    .option('--no-scan', helpText.noScanOption)
+    .action(async (targetPath, options) => {
+    const { initCommand } = await import('./commands/init.js');
+    await initCommand({
+        ...commandOptions(options),
+        targetPath: resolveTargetPathArg(targetPath, options, 'init'),
+    });
+});
+program
+    .command('scan')
+    .description(helpText.scanDescription)
+    .option('--dry-run', helpText.dryRun)
+    .option('--force', helpText.forceOption)
+    .option('--language <language>', helpText.languageOption)
+    .action(async (options) => {
+    const { scanCommand } = await import('./commands/scan.js');
+    await scanCommand(commandOptions(options));
+});
+program
+    .command('clarify [feature]')
+    .description(helpText.clarifyDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .action(async (feature, options) => {
+    const { clarifyCommand } = await import('./commands/clarify.js');
+    await clarifyCommand(feature, options);
+});
+program
+    .command('docs [change]')
+    .description(helpText.docsDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .action(async (change, options) => {
+    const { docsCommand } = await import('./commands/docs.js');
+    await docsCommand(change, options);
+});
+program
+    .command('design [change]')
+    .description(helpText.designDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .action(async (change, options) => {
+    const { designCommand } = await import('./commands/design.js');
+    await designCommand(change, options);
+});
+program
+    .command('implement [task]')
+    .description(helpText.implementDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .action(async (task, options) => {
+    const { implementCommand } = await import('./commands/implement.js');
+    await implementCommand(task, options);
+});
+program
+    .command('pipeline')
+    .description(helpText.pipelineDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .action(async (options) => {
+    const { pipelineCommand } = await import('./commands/pipeline.js');
+    await pipelineCommand(options);
+});
+program
+    .command('verify [change]')
+    .description(helpText.verifyDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .action(async (change, options) => {
+    const { verifyCommand } = await import('./commands/verify.js');
+    await verifyCommand(change, options);
+});
+program
+    .command('archive [change]')
+    .description(helpText.archiveDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .action(async (change, options) => {
+    const { archiveCommand } = await import('./commands/archive.js');
+    await archiveCommand(change, options);
+});
+program
+    .command('status [path]')
+    .description(helpText.statusDescription)
+    .option('--json', helpText.jsonOption)
+    .action(async (targetPath = '.', options) => {
+    const { statusCommand } = await import('./commands/status.js');
+    await statusCommand(targetPath, options);
+});
+program
+    .command('update [targetPath]')
+    .description(helpText.updateDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .option('--scope <scope>', helpText.updateScopeOption, 'auto')
+    .option('--dry-run', helpText.dryRun)
+    .option('--json', helpText.jsonOption)
+    .option('--no-hooks', helpText.noHooksUpdateOption)
+    .option('--with-package', helpText.withPackageOption)
+    .action(async (targetPath, options) => {
+    const { updateCommand } = await import('./commands/update.js');
+    await updateCommand({
+        ...commandOptions(options),
+        targetPath: resolveTargetPathArg(targetPath, options, 'update'),
+    });
+});
+program
+    .command('doctor [targetPath]')
+    .description(helpText.doctorDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .option('--scope <scope>', helpText.commandScopeOption, 'global')
+    .option('--json', helpText.jsonOption)
+    .action(async (targetPath, options) => {
+    const { doctorCommand } = await import('./commands/doctor.js');
+    await doctorCommand({
+        ...commandOptions(options),
+        targetPath: resolveTargetPathArg(targetPath, options, 'doctor'),
+    });
+});
+program
+    .command('uninstall [targetPath]')
+    .description(helpText.uninstallDescription)
+    .option('--agent <agent>', helpText.agentOption, 'both')
+    .option('--scope <scope>', helpText.commandScopeOption, 'global')
+    .option('--dry-run', helpText.dryRun)
+    .option('--json', helpText.jsonOption)
+    .option('--force', helpText.uninstallForceOption)
+    .option('--with-deps', helpText.withDepsOption)
+    .action(async (targetPath, options) => {
+    const { uninstallCommand } = await import('./commands/uninstall.js');
+    await uninstallCommand({
+        ...commandOptions(options),
+        targetPath: resolveTargetPathArg(targetPath, options, 'uninstall'),
+    });
+});
+program
+    .command('check <change>')
+    .description('检查 SDD change 的文档完整性')
+    .option('--json', '输出 JSON')
+    .action(async (change, options) => {
+    const { checkCommand } = await import('./commands/check.js');
+    await checkCommand(change, { json: options.json });
+});
+program
+    .command('config <change>')
+    .description('Set workflow config for a change (review_mode, auto_transition)')
+    .option('--review-mode <mode>', 'Review mode: off | standard | thorough')
+    .option('--auto-transition <bool>', 'Auto-advance phases: true | false')
+    .option('--json', 'Output JSON')
+    .action(async (change, options) => {
+    const { configCommand } = await import('./commands/config.js');
+    await configCommand(change, {
+        reviewMode: options.reviewMode,
+        autoTransition: options.autoTransition,
+        json: options.json,
+    });
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/app/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/app/cli.ts"],"names":[],"mappings":"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"}

package/dist/app/commands/archive.js

@@ -0,0 +1,6 @@
+import { checkSkillDeployment } from '../../domains/skill/check.js';
+const SKILL_NAME = 'superflow-archive';
+export async function archiveCommand(_change, options = {}) {
+    checkSkillDeployment(SKILL_NAME, options);
+}
+//# sourceMappingURL=archive.js.map

package/dist/app/commands/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../../src/app/commands/archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAA0B,MAAM,8BAA8B,CAAC;AAE5F,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAAgB,EAChB,UAA6B,EAAE;IAE/B,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/app/commands/check.js

@@ -0,0 +1,132 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'fs';
+import path from 'path';
+const REQUIRED_DOCS = [
+    { file: '.openspec.yaml' },
+    { file: 'proposal.md', note: '背景、目标、非目标、影响范围、验收标准' },
+    { file: 'api.md', note: 'API 合同（纯 CLI 项目可标注 N/A 并说明原因）' },
+    { file: 'design.md', note: '设计方案' },
+    { file: 'tasks.md', note: '任务拆分，checkbox 格式' },
+    { file: 'tests.md', note: '测试用例，含可执行命令和 RED/GREEN 预期' },
+    { file: 'traceability-matrix.md', note: '需求→测试追溯矩阵' },
+    { file: 'review-checklist.md', note: '评审检查清单' },
+    { file: 'sdd-quality-gate.md', note: '质量门禁状态' },
+    { file: 'test-report.md', note: '测试报告（实现前可留占位）' },
+];
+const SPEC_ALTERNATIVES = ['spec.md', 'specs'];
+const HANDOFF_FILES = [
+    '.sdd/handoff/sdd-context.md',
+    '.sdd/handoff/sdd-context.json',
+    '.sdd/handoff/sdd-context.sha256',
+];
+const PROMPT_INDICATOR = 'prompt';
+export async function checkCommand(changeName, options = {}) {
+    const projectPath = path.resolve(options.projectPath ?? process.cwd());
+    const changeDir = path.join(projectPath, 'openspec', 'changes', changeName);
+    if (!existsSync(changeDir)) {
+        console.error(`错误：change 目录不存在: ${changeDir}`);
+        process.exit(1);
+    }
+    const result = collectCheck(changeDir, changeName);
+    if (options.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        printCheck(result);
+    }
+    if (result.failed > 0) {
+        process.exit(1);
+    }
+}
+export function collectCheck(changeDir, changeName) {
+    const items = [];
+    const statePhase = readPhase(changeDir);
+    // 必备文档
+    for (const doc of REQUIRED_DOCS) {
+        items.push({
+            file: doc.file,
+            required: true,
+            exists: existsSync(path.join(changeDir, doc.file)),
+            note: doc.note,
+        });
+    }
+    // spec.md 或 specs/ 目录
+    const hasSpec = SPEC_ALTERNATIVES.some((alt) => existsSync(path.join(changeDir, alt)));
+    items.push({
+        file: 'spec.md 或 specs/',
+        required: true,
+        exists: hasSpec,
+        note: '规格文档',
+    });
+    // Handoff 文件
+    for (const hf of HANDOFF_FILES) {
+        items.push({
+            file: hf,
+            required: true,
+            exists: existsSync(path.join(changeDir, hf)),
+        });
+    }
+    // state.yaml
+    const stateYaml = '.sdd/state.yaml';
+    items.push({
+        file: stateYaml,
+        required: true,
+        exists: existsSync(path.join(changeDir, stateYaml)),
+    });
+    // understand-anything 索引（项目级影响面发现前置条件）
+    const projectRoot = path.resolve(changeDir, '..', '..', '..');
+    const uaGraph = path.join(projectRoot, '.understand-anything', 'knowledge-graph.json');
+    items.push({
+        file: '.understand-anything/knowledge-graph.json',
+        required: statePhase === 'docs' || statePhase === 'design',
+        exists: existsSync(uaGraph),
+        note: '平台级影响面发现前置条件（缺失将阻塞 docs/design 门禁，需跑 /understand 或降级手动分析）',
+    });
+    // Prompt 文件（docs 阶段后期必须）
+    const promptDir = path.join(changeDir, PROMPT_INDICATOR);
+    const hasPromptDir = existsSync(promptDir) && statSync(promptDir).isDirectory();
+    const hasPromptFiles = hasPromptDir &&
+        readdirSync(promptDir).some((f) => f.endsWith('.md'));
+    items.push({
+        file: 'prompt/*.md',
+        required: statePhase === 'implement' || statePhase === 'verify',
+        exists: hasPromptFiles,
+        note: '实现 prompt（implement 阶段前必须）',
+    });
+    const passed = items.filter((i) => i.exists || !i.required).length;
+    const failed = items.filter((i) => !i.exists && i.required).length;
+    return { change: changeName, phase: statePhase, passed, failed, items };
+}
+function readPhase(changeDir) {
+    const stateFile = path.join(changeDir, '.sdd', 'state.yaml');
+    if (!existsSync(stateFile))
+        return 'unknown';
+    try {
+        const content = readFileSync(stateFile, 'utf-8');
+        for (const line of content.split('\n')) {
+            if (line.trimStart().startsWith('phase:')) {
+                return line.split(':')[1]?.trim() ?? 'unknown';
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return 'unknown';
+}
+function printCheck(result) {
+    console.log(`\n📋 ${result.change} (phase: ${result.phase})`);
+    console.log(`   通过: ${result.passed}  缺失: ${result.failed}\n`);
+    for (const item of result.items) {
+        const icon = item.exists ? '✅' : item.required ? '❌' : '⚪';
+        const note = item.note ? ` — ${item.note}` : '';
+        console.log(`  ${icon} ${item.file}${note}`);
+    }
+    if (result.failed > 0) {
+        console.log(`\n⚠️  缺失 ${result.failed} 个必备文件。`);
+        console.log('   补齐后运行: superflow-guard.sh <change-dir> docs');
+    }
+    else {
+        console.log('\n✅ 文档完整性检查通过。');
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/app/commands/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../../src/app/commands/check.ts"],"names":[],"mappings":"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"}

package/dist/app/commands/clarify.js

@@ -0,0 +1,6 @@
+import { checkSkillDeployment } from '../../domains/skill/check.js';
+const SKILL_NAME = 'superflow-clarify';
+export async function clarifyCommand(_feature, options = {}) {
+    checkSkillDeployment(SKILL_NAME, options);
+}
+//# sourceMappingURL=clarify.js.map

package/dist/app/commands/clarify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clarify.js","sourceRoot":"","sources":["../../../src/app/commands/clarify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAA0B,MAAM,8BAA8B,CAAC;AAE5F,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,QAAiB,EACjB,UAA6B,EAAE;IAE/B,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}

package/dist/app/commands/config.js

@@ -0,0 +1,103 @@
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import path from 'path';
+import { logReviewModeChange, logAutoTransitionToggle } from '../../domains/state-events.js';
+/**
+ * 设置 SDD change 的工作流配置字段。
+ * 当前支持: review_mode, auto_transition
+ */
+export async function configCommand(changeName, options = {}) {
+    const projectPath = path.resolve(options.projectPath ?? process.cwd());
+    const changeDir = path.join(projectPath, 'openspec', 'changes', changeName);
+    const stateFile = path.join(changeDir, '.sdd', 'state.yaml');
+    if (!existsSync(stateFile)) {
+        console.error(`错误：未找到 ${changeName} 的 .sdd/state.yaml。请先运行 superflow init。`);
+        process.exit(1);
+    }
+    const content = readFileSync(stateFile, 'utf-8');
+    const updated = {};
+    let newContent = content;
+    if (options.reviewMode) {
+        const mode = normalizeReviewMode(options.reviewMode);
+        newContent = setYamlField(newContent, 'review_mode', mode);
+        updated['review_mode'] = mode;
+        logReviewModeChange(changeDir, extractYamlField(content, 'review_mode') ?? 'null', mode);
+    }
+    if (options.autoTransition !== undefined) {
+        const val = normalizeBool(options.autoTransition);
+        newContent = setYamlField(newContent, 'auto_transition', val);
+        updated['auto_transition'] = val;
+        logAutoTransitionToggle(changeDir, val === 'true');
+    }
+    if (Object.keys(updated).length === 0) {
+        console.log('未指定要修改的字段。支持: --review-mode, --auto-transition');
+        return;
+    }
+    const dir = path.dirname(stateFile);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(stateFile, newContent, 'utf-8');
+    if (options.json) {
+        console.log(JSON.stringify({ change: changeName, updated }, null, 2));
+    }
+    else {
+        console.log(`已更新 ${changeName} 配置:`);
+        for (const [key, val] of Object.entries(updated)) {
+            console.log(`  ${key}: ${val}`);
+        }
+    }
+}
+function normalizeReviewMode(value) {
+    const mode = value.trim().toLowerCase();
+    if (mode === 'off' || mode === 'standard' || mode === 'thorough')
+        return mode;
+    throw new Error(`无效的 review_mode: "${value}"。可选: off, standard, thorough`);
+}
+function normalizeBool(value) {
+    const v = value.trim().toLowerCase();
+    if (v === 'true' || v === '1' || v === 'yes')
+        return 'true';
+    if (v === 'false' || v === '0' || v === 'no')
+        return 'false';
+    throw new Error(`无效的布尔值: "${value}"。可选: true, false`);
+}
+function setYamlField(content, key, value) {
+    const lines = content.split(/\r?\n/);
+    const keyLine = lines.findIndex((line) => line.trimStart().startsWith(`${key}:`));
+    if (keyLine >= 0) {
+        const indent = lines[keyLine].match(/^(\s*)/)?.[1] ?? '';
+        lines[keyLine] = `${indent}${key}: ${value}`;
+    }
+    else {
+        lines.push(`${key}: ${value}`);
+    }
+    return lines.join('\n') + '\n';
+}
+function extractYamlField(content, key) {
+    for (const line of content.split(/\r?\n/)) {
+        if (line.trimStart().startsWith(`${key}:`)) {
+            return line.split(':')[1]?.trim();
+        }
+    }
+    return undefined;
+}
+/** 读取当前 change 的 review_mode */
+export function getReviewMode(changeDir) {
+    const stateFile = path.join(changeDir, '.sdd', 'state.yaml');
+    if (!existsSync(stateFile))
+        return 'standard';
+    const content = readFileSync(stateFile, 'utf-8');
+    const val = extractYamlField(content, 'review_mode');
+    if (val === 'off' || val === 'standard' || val === 'thorough')
+        return val;
+    return 'standard';
+}
+/** 读取当前 change 的 auto_transition */
+export function getAutoTransition(changeDir) {
+    const stateFile = path.join(changeDir, '.sdd', 'state.yaml');
+    if (!existsSync(stateFile))
+        return true;
+    const content = readFileSync(stateFile, 'utf-8');
+    const val = extractYamlField(content, 'auto_transition');
+    return val !== 'false';
+}
+//# sourceMappingURL=config.js.map

package/dist/app/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/app/commands/config.ts"],"names":[],"mappings":"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"}

package/dist/app/commands/design.js

@@ -0,0 +1,28 @@
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { checkSkillDeployment, } from "../../domains/skill/check.js";
+const SKILL_NAME = "superflow-design";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const GUARD = path.resolve(__dirname, "..", "..", "assets", "skills", "superflow-pipeline", "scripts", "superflow-guard.sh");
+export async function designCommand(change, options = {}) {
+    if (change) {
+        runDesignGuard(resolveChangeDir(change));
+    }
+    checkSkillDeployment(SKILL_NAME, options);
+}
+function resolveChangeDir(change) {
+    const direct = path.resolve(change);
+    if (existsSync(direct))
+        return direct;
+    const openspecChange = path.resolve("openspec", "changes", change);
+    if (existsSync(openspecChange))
+        return openspecChange;
+    return direct;
+}
+function runDesignGuard(changeDir) {
+    execFileSync("bash", [GUARD, changeDir, "design"], { stdio: "inherit" });
+}
+//# sourceMappingURL=design.js.map

package/dist/app/commands/design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design.js","sourceRoot":"","sources":["../../../src/app/commands/design.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,oBAAoB,GAErB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,UAAU,GAAG,kBAAkB,CAAC;AACtC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CACxB,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,SAAS,EACT,oBAAoB,CACrB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAe,EACf,UAA6B,EAAE;IAE/B,IAAI,MAAM,EAAE,CAAC;QACX,cAAc,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAc;IACtC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IAEtC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IACnE,IAAI,UAAU,CAAC,cAAc,CAAC;QAAE,OAAO,cAAc,CAAC;IAEtD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,SAAiB;IACvC,YAAY,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;AAC3E,CAAC"}

package/dist/app/commands/docs.js

@@ -0,0 +1,6 @@
+import { checkSkillDeployment } from '../../domains/skill/check.js';
+const SKILL_NAME = 'superflow-docs';
+export async function docsCommand(_change, options = {}) {
+    checkSkillDeployment(SKILL_NAME, options);
+}
+//# sourceMappingURL=docs.js.map

package/dist/app/commands/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../../src/app/commands/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAA0B,MAAM,8BAA8B,CAAC;AAE5F,MAAM,UAAU,GAAG,gBAAgB,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAgB,EAChB,UAA6B,EAAE;IAE/B,oBAAoB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC"}