@qnroa/qtype 0.0.1

package/dist/cli/commands/content/index.js

@@ -0,0 +1,22 @@
+import { t } from '../../i18n/index.js';
+import { contentLintCmd } from './lint/index.js';
+import { contentValidateCmd } from './validate/index.js';
+import { contentSearchCmd } from './search/index.js';
+export const contentCmd = {
+    name: 'content',
+    summary: () => t('content.summary'),
+    describe: () => t('content.description'),
+    messages: {
+        'zh-CN': {
+            'content.summary': '内容检查',
+            'content.description': '仓库内容检查与搜索（material/*.md）',
+        },
+        'en-US': {
+            'content.summary': 'Content tools',
+            'content.description': 'Repo content checks and search over material/*.md',
+        },
+    },
+    subcommands: [contentLintCmd, contentValidateCmd, contentSearchCmd],
+};
+export { contentLintAction } from './lint/action.js';
+export { contentValidateAction } from './validate/action.js';

package/dist/cli/commands/content/lint/action.js

@@ -0,0 +1,102 @@
+/**
+ * `qtype content lint` action — format-lint material/*.md.
+ *
+ * Checks (per-file / per-card):
+ *   - File-level title: `title: <str>` frontmatter or a top `# Heading` (warning)
+ *   - Each file parses to at least one Q/A card (error)
+ *   - No card contains characters unmapped in the keystroke plan (error)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { info, success, error, warn } from '../../../utils/output.js';
+import { ensureQtypeRepo } from '../../../utils/repoGuard.js';
+import { t } from '../../../i18n/index.js';
+import { parseMaterial } from '../../../../core/parser/parseMaterial.js';
+const TITLE_RE = /^title:\s*(.+)$/m;
+const HEADING_RE = /^#\s+.+$/m;
+export async function contentLintAction(opts = {}) {
+    const root = ensureQtypeRepo(opts.path ?? process.cwd());
+    const materialDir = path.join(root, 'material');
+    if (!opts.json)
+        info(t('content.lint.msg.scanning', { path: root }));
+    const issues = [];
+    let cardTotal = 0;
+    let materialCount = 0;
+    if (fs.existsSync(materialDir)) {
+        for (const name of fs.readdirSync(materialDir).sort()) {
+            if (!name.endsWith('.md'))
+                continue;
+            materialCount++;
+            const rel = path.posix.join('material', name);
+            const src = fs.readFileSync(path.join(materialDir, name), 'utf8');
+            // File-level title (soft): warn if neither frontmatter title nor
+            // a top-level heading is present — the browser view has nothing to
+            // show as the material's name.
+            const head = src.slice(0, 2048);
+            if (!TITLE_RE.test(head) && !HEADING_RE.test(head)) {
+                issues.push({
+                    code: 'material.emptyTitle',
+                    path: rel,
+                    message: t('content.lint.issue.emptyTitle', { path: rel }),
+                });
+            }
+            const material = parseMaterial(src, rel);
+            cardTotal += material.cards.length;
+            if (material.cards.length === 0) {
+                issues.push({
+                    code: 'material.noCards',
+                    path: rel,
+                    message: t('content.lint.issue.noCards', { path: rel }),
+                });
+                continue;
+            }
+            material.cards.forEach((c, i) => {
+                if (c.unknownChars.length > 0) {
+                    const chars = [...new Set(c.unknownChars)];
+                    issues.push({
+                        code: 'material.unknownChars',
+                        path: rel,
+                        card: i + 1,
+                        chars,
+                        message: t('content.lint.issue.unknownChars', {
+                            path: rel,
+                            card: i + 1,
+                            chars: chars.join(' '),
+                        }),
+                    });
+                }
+            });
+        }
+    }
+    // `emptyTitle` is treated as a warning (informational). Anything else is an error.
+    const errorIssues = issues.filter((i) => i.code !== 'material.emptyTitle');
+    const result = {
+        ok: errorIssues.length === 0,
+        stats: { materials: materialCount, cards: cardTotal },
+        issues,
+    };
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else if (issues.length === 0) {
+        success(t('content.lint.msg.ok'));
+    }
+    else {
+        if (errorIssues.length > 0) {
+            error(t('content.lint.msg.issues', { count: errorIssues.length }));
+            for (const i of errorIssues.slice(0, 30)) {
+                console.error(`    - ${i.message}`);
+            }
+            if (errorIssues.length > 30) {
+                console.error(`    ${t('content.lint.msg.andMore', { count: errorIssues.length - 30 })}`);
+            }
+        }
+        const warnIssues = issues.filter((i) => i.code === 'material.emptyTitle');
+        for (const w of warnIssues)
+            warn(w.message);
+        if (result.ok)
+            success(t('content.lint.msg.ok'));
+    }
+    if (!result.ok)
+        process.exitCode = 1;
+}

package/dist/cli/commands/content/lint/i18n.js

@@ -0,0 +1,32 @@
+export const messages = {
+    'zh-CN': {
+        'content.lint.summary': '资料格式检查',
+        'content.lint.description': '检查 material/*.md 的 frontmatter 与 Q/A 卡片结构是否合规',
+        'content.lint.arg.path': '仓库路径（默认当前目录）',
+        'content.lint.opt.json': '以 JSON 格式输出（机器可解析）',
+        'content.lint.example.basic': '扫描当前仓库',
+        'content.lint.example.json': 'CI 模式，JSON 输出',
+        'content.lint.msg.scanning': '扫描 {path}',
+        'content.lint.msg.ok': '所有 material/*.md 通过格式检查',
+        'content.lint.msg.issues': '发现 {count} 个问题：',
+        'content.lint.msg.andMore': '... 另有 {count} 条',
+        'content.lint.issue.noCards': '{path}: 未识别到任何 Q/A 卡片',
+        'content.lint.issue.unknownChars': '{path}#{card}: 含无法练习的字符 → {chars}',
+        'content.lint.issue.emptyTitle': '{path}: frontmatter 缺少 title',
+    },
+    'en-US': {
+        'content.lint.summary': 'Material format lint',
+        'content.lint.description': 'Check frontmatter and Q/A card structure of material/*.md',
+        'content.lint.arg.path': 'Repo path (default: current directory)',
+        'content.lint.opt.json': 'Output as JSON (machine-readable)',
+        'content.lint.example.basic': 'Scan current repo',
+        'content.lint.example.json': 'CI mode, JSON output',
+        'content.lint.msg.scanning': 'Scanning {path}',
+        'content.lint.msg.ok': 'All material/*.md passed format lint',
+        'content.lint.msg.issues': 'Found {count} issue(s):',
+        'content.lint.msg.andMore': '... and {count} more',
+        'content.lint.issue.noCards': '{path}: no Q/A cards parsed',
+        'content.lint.issue.unknownChars': '{path}#{card}: non-typable chars → {chars}',
+        'content.lint.issue.emptyTitle': '{path}: frontmatter missing title',
+    },
+};

package/dist/cli/commands/content/lint/index.js

@@ -0,0 +1,19 @@
+import { t } from '../../../i18n/index.js';
+import { messages } from './i18n.js';
+import { contentLintAction } from './action.js';
+export const contentLintCmd = {
+    name: 'lint',
+    messages,
+    summary: () => t('content.lint.summary'),
+    describe: () => t('content.lint.description'),
+    args: [{ flag: '[path]', describe: () => t('content.lint.arg.path') }],
+    options: [{ flags: '--json', describe: () => t('content.lint.opt.json') }],
+    examples: () => [
+        { command: 'qtype content lint', describe: () => t('content.lint.example.basic') },
+        { command: 'qtype content lint --json', describe: () => t('content.lint.example.json') },
+    ],
+    seeAlso: ['content validate'],
+    action: async (pathArg, opts) => {
+        await contentLintAction({ path: pathArg, json: opts.json });
+    },
+};

package/dist/cli/commands/content/search/action.js

@@ -0,0 +1,64 @@
+/**
+ * `qtype content search <query>` action — grep-style search over material/*.md.
+ *
+ * Simple case-insensitive substring match on card questions + answers. Not
+ * ranked — just returns first-N hits so a user can pipe grep-style output
+ * into vim/less. Deliberately dumb: fits the "types of cards, not a knowledge
+ * graph" scope of qtype.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { info, dim } from '../../../utils/output.js';
+import { ensureQtypeRepo } from '../../../utils/repoGuard.js';
+import { t } from '../../../i18n/index.js';
+import { parseMaterial } from '../../../../core/parser/parseMaterial.js';
+export async function contentSearchAction(query, opts = {}) {
+    const root = ensureQtypeRepo(opts.path ?? process.cwd());
+    const materialDir = path.join(root, 'material');
+    const limit = opts.limit ?? 20;
+    const q = query.toLowerCase();
+    const hits = [];
+    if (fs.existsSync(materialDir)) {
+        outer: for (const name of fs.readdirSync(materialDir).sort()) {
+            if (!name.endsWith('.md'))
+                continue;
+            const rel = path.posix.join('material', name);
+            const src = fs.readFileSync(path.join(materialDir, name), 'utf8');
+            const material = parseMaterial(src, rel);
+            material.cards.forEach((card, i) => {
+                const qLc = card.question.toLowerCase();
+                const aLc = card.answer.toLowerCase();
+                if (!qLc.includes(q) && !aLc.includes(q))
+                    return;
+                const snippetSrc = qLc.includes(q) ? card.question : card.answer;
+                const idx = snippetSrc.toLowerCase().indexOf(q);
+                const start = Math.max(0, idx - 20);
+                const end = Math.min(snippetSrc.length, idx + q.length + 40);
+                const snippet = (start > 0 ? '…' : '') +
+                    snippetSrc.slice(start, end).replace(/\n+/g, ' ') +
+                    (end < snippetSrc.length ? '…' : '');
+                hits.push({
+                    file: rel,
+                    card: i + 1,
+                    question: card.question,
+                    answer: card.answer,
+                    snippet,
+                });
+                if (hits.length >= limit)
+                    return;
+            });
+            if (hits.length >= limit)
+                break outer;
+        }
+    }
+    if (hits.length === 0) {
+        info(t('content.search.msg.noResults'));
+        return;
+    }
+    console.log(t('content.search.msg.results', { count: hits.length }));
+    console.log('');
+    for (const h of hits) {
+        console.log(`  ${h.file}#${h.card}`);
+        console.log(`    ${h.question}  ${dim(h.snippet)}`);
+    }
+}

package/dist/cli/commands/content/search/i18n.js

@@ -0,0 +1,20 @@
+export const messages = {
+    'zh-CN': {
+        'content.search.summary': '全文搜索',
+        'content.search.description': '在 material/*.md 中搜索关键词（匹配问题与答案）',
+        'content.search.arg.query': '搜索关键词',
+        'content.search.arg.path': '仓库路径（默认当前目录）',
+        'content.search.opt.limit': '最多返回结果数（默认 20）',
+        'content.search.msg.noResults': '没有找到匹配的结果',
+        'content.search.msg.results': '找到 {count} 个结果',
+    },
+    'en-US': {
+        'content.search.summary': 'Full-text search',
+        'content.search.description': 'Search material/*.md for a query (matches questions and answers)',
+        'content.search.arg.query': 'Search query',
+        'content.search.arg.path': 'Repo path (default: current directory)',
+        'content.search.opt.limit': 'Max results (default: 20)',
+        'content.search.msg.noResults': 'No results found',
+        'content.search.msg.results': 'Found {count} results',
+    },
+};

package/dist/cli/commands/content/search/index.js

@@ -0,0 +1,24 @@
+import { t } from '../../../i18n/index.js';
+import { messages } from './i18n.js';
+import { contentSearchAction } from './action.js';
+export const contentSearchCmd = {
+    name: 'search',
+    messages,
+    summary: () => t('content.search.summary'),
+    describe: () => t('content.search.description'),
+    args: [
+        { flag: '<query>', describe: () => t('content.search.arg.query') },
+        { flag: '[path]', describe: () => t('content.search.arg.path') },
+    ],
+    options: [
+        {
+            flags: '--limit <n>',
+            describe: () => t('content.search.opt.limit'),
+            parser: (v) => parseInt(v, 10),
+            defaultValue: 20,
+        },
+    ],
+    action: async (query, pathArg, opts) => {
+        await contentSearchAction(query, { path: pathArg, limit: opts.limit });
+    },
+};

package/dist/cli/commands/content/validate/action.js

@@ -0,0 +1,145 @@
+/**
+ * `qtype content validate` action — cross-file validation of material/*.md.
+ *
+ * Cross-file checks (things `content lint` misses because it looks at each
+ * file in isolation):
+ *   - Duplicate material filenames (across case-insensitive collisions)
+ *   - Duplicate card questions (identical Q text in two places → likely
+ *     copy-paste bug)
+ *   - Any unknown chars (also caught by lint, re-reported so validate is
+ *     self-sufficient in CI)
+ *   - Tag consistency: warns when the same tag is used with different
+ *     casing (`react` vs `React`)
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { info, success, error, warn } from '../../../utils/output.js';
+import { ensureQtypeRepo } from '../../../utils/repoGuard.js';
+import { t } from '../../../i18n/index.js';
+import { parseMaterial } from '../../../../core/parser/parseMaterial.js';
+export async function contentValidateAction(opts = {}) {
+    const root = ensureQtypeRepo(opts.path ?? process.cwd());
+    const materialDir = path.join(root, 'material');
+    if (!opts.json)
+        info(t('content.validate.msg.validating', { path: root }));
+    const errors = [];
+    const warnings = [];
+    let cardTotal = 0;
+    const files = [];
+    // ── Filename uniqueness (case-insensitive) ──────────────
+    if (fs.existsSync(materialDir)) {
+        const seen = new Map();
+        for (const name of fs.readdirSync(materialDir).sort()) {
+            if (!name.endsWith('.md'))
+                continue;
+            files.push(name);
+            const key = name.toLowerCase();
+            const prior = seen.get(key);
+            if (prior && prior !== name) {
+                errors.push({
+                    code: 'duplicate.file',
+                    path: name,
+                    message: t('content.validate.err.duplicateFile', { file: name }),
+                    extra: { collidesWith: prior },
+                });
+            }
+            else {
+                seen.set(key, name);
+            }
+        }
+    }
+    // ── Parse every material, then run cross-file checks ────
+    const questionIndex = new Map(); // normalized Q → "path#card"
+    const tagVariants = new Map(); // lower → { original casings }
+    for (const name of files) {
+        const rel = path.posix.join('material', name);
+        const src = fs.readFileSync(path.join(materialDir, name), 'utf8');
+        const material = parseMaterial(src, rel);
+        cardTotal += material.cards.length;
+        material.cards.forEach((card, i) => {
+            const cardIdx = i + 1;
+            // Unknown chars — also caught by lint; re-report so validate stands alone.
+            if (card.unknownChars.length > 0) {
+                const chars = [...new Set(card.unknownChars)];
+                errors.push({
+                    code: 'material.unknownChars',
+                    path: rel,
+                    message: t('content.validate.err.unknownChars', {
+                        path: rel,
+                        card: cardIdx,
+                        chars: chars.join(' '),
+                    }),
+                    extra: { chars },
+                });
+            }
+            // Duplicate card questions across the corpus.
+            const key = card.question.trim().toLowerCase();
+            if (key.length > 0) {
+                const prior = questionIndex.get(key);
+                const here = `${rel}#${cardIdx}`;
+                if (prior && prior !== here) {
+                    errors.push({
+                        code: 'duplicate.card',
+                        path: rel,
+                        message: t('content.validate.err.duplicateCard', {
+                            path: rel,
+                            card: cardIdx,
+                            other: prior,
+                        }),
+                        extra: { collidesWith: prior },
+                    });
+                }
+                else {
+                    questionIndex.set(key, here);
+                }
+            }
+            // Tag casing consistency.
+            for (const tag of card.meta.tags) {
+                const lower = tag.toLowerCase();
+                const set = tagVariants.get(lower) ?? new Set();
+                set.add(tag);
+                tagVariants.set(lower, set);
+            }
+        });
+    }
+    for (const [lower, variants] of tagVariants) {
+        if (variants.size > 1) {
+            warnings.push({
+                code: 'tag.caseInconsistent',
+                message: t('content.validate.warn.tagCase', {
+                    tag: lower,
+                    variants: [...variants].join(', '),
+                }),
+                extra: { variants: [...variants] },
+            });
+        }
+    }
+    const result = {
+        ok: errors.length === 0,
+        stats: { materials: files.length, cards: cardTotal, warnings: warnings.length },
+        errors,
+        warnings,
+    };
+    if (opts.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        for (const e of errors)
+            error(e.message);
+        for (const w of warnings)
+            warn(w.message);
+        console.log('');
+        if (result.ok) {
+            success(t('content.validate.msg.ok', {
+                materials: result.stats.materials,
+                cards: result.stats.cards,
+                warnings: result.stats.warnings,
+            }));
+        }
+        else {
+            error(t('content.validate.msg.errorCount', { count: errors.length }));
+        }
+    }
+    if (!result.ok)
+        process.exitCode = 1;
+}

package/dist/cli/commands/content/validate/i18n.js

@@ -0,0 +1,32 @@
+export const messages = {
+    'zh-CN': {
+        'content.validate.summary': '全量校验',
+        'content.validate.description': '跨文件校验：文件名唯一 / 标签一致 / 无重复卡片 / 无未知字符',
+        'content.validate.arg.path': '仓库路径（默认当前目录）',
+        'content.validate.opt.json': '以 JSON 格式输出（机器可解析）',
+        'content.validate.example.basic': '校验当前仓库',
+        'content.validate.example.json': 'CI 模式，JSON 输出',
+        'content.validate.msg.validating': '校验 {path}',
+        'content.validate.msg.ok': '校验通过 (materials={materials} cards={cards} warnings={warnings})',
+        'content.validate.msg.errorCount': '共 {count} 个错误',
+        'content.validate.err.duplicateFile': '重名 material 文件：{file}',
+        'content.validate.err.duplicateCard': '{path}#{card} 与 {other} 的问题完全相同',
+        'content.validate.err.unknownChars': '{path}#{card}: 含无法练习的字符 → {chars}',
+        'content.validate.warn.tagCase': "标签 '{tag}' 大小写不一致：{variants}",
+    },
+    'en-US': {
+        'content.validate.summary': 'Full validation',
+        'content.validate.description': 'Cross-file checks: unique filenames, tag consistency, no duplicate cards, no unknown chars',
+        'content.validate.arg.path': 'Repo path (default: current directory)',
+        'content.validate.opt.json': 'Output as JSON (machine-readable)',
+        'content.validate.example.basic': 'Validate current repo',
+        'content.validate.example.json': 'CI mode, JSON output',
+        'content.validate.msg.validating': 'Validating {path}',
+        'content.validate.msg.ok': 'Validation passed (materials={materials} cards={cards} warnings={warnings})',
+        'content.validate.msg.errorCount': '{count} error(s) total',
+        'content.validate.err.duplicateFile': 'Duplicate material filename: {file}',
+        'content.validate.err.duplicateCard': "{path}#{card} shares the question of {other}",
+        'content.validate.err.unknownChars': '{path}#{card}: non-typable chars → {chars}',
+        'content.validate.warn.tagCase': "Tag '{tag}' has inconsistent casing: {variants}",
+    },
+};

package/dist/cli/commands/content/validate/index.js

@@ -0,0 +1,19 @@
+import { t } from '../../../i18n/index.js';
+import { messages } from './i18n.js';
+import { contentValidateAction } from './action.js';
+export const contentValidateCmd = {
+    name: 'validate',
+    messages,
+    summary: () => t('content.validate.summary'),
+    describe: () => t('content.validate.description'),
+    args: [{ flag: '[path]', describe: () => t('content.validate.arg.path') }],
+    options: [{ flags: '--json', describe: () => t('content.validate.opt.json') }],
+    examples: () => [
+        { command: 'qtype content validate', describe: () => t('content.validate.example.basic') },
+        { command: 'qtype content validate --json', describe: () => t('content.validate.example.json') },
+    ],
+    seeAlso: ['content lint', 'publish build'],
+    action: async (pathArg, opts) => {
+        await contentValidateAction({ path: pathArg, json: opts.json });
+    },
+};

package/dist/cli/commands/index.js

@@ -0,0 +1,19 @@
+import { initCmd } from './init/index.js';
+import { repoCmd } from './repo/index.js';
+import { publishCmd } from './publish/index.js';
+import { checkCmd } from './check/index.js';
+import { contentCmd } from './content/index.js';
+import { configCmd } from './config/index.js';
+import { pluginCmd } from './plugin/index.js';
+import { packCmd } from './pack/index.js';
+export const allCommands = [
+    initCmd,
+    repoCmd,
+    publishCmd,
+    checkCmd,
+    contentCmd,
+    packCmd,
+    pluginCmd,
+    configCmd,
+];
+export { initCmd, repoCmd, publishCmd, checkCmd, contentCmd, packCmd, pluginCmd, configCmd, };

package/dist/cli/commands/init/index.js

@@ -0,0 +1,53 @@
+/**
+ * `qtype init` — top-level alias for `qtype repo sync`.
+ *
+ * Lives at the top level (not under `repo/`) because it's the standard
+ * "drop QTYPE into this directory" entry point new users look for —
+ * mirroring `git init`, `npm init`, etc. The actual scaffolding logic
+ * lives in repoSyncAction; this is just a shorter, more discoverable
+ * front door.
+ */
+import os from 'node:os';
+import path from 'node:path';
+import { t, getLocale } from '../../i18n/index.js';
+import { userKv } from '../../bootstrap.js';
+import { warn } from '../../utils/output.js';
+import { repoSyncAction } from '../repo/sync/action.js';
+import { messages as syncMessages } from '../repo/sync/i18n.js';
+function warnIfHome(dir) {
+    if (path.resolve(dir) === os.homedir())
+        warn(t('msg.home.warn'));
+}
+export const initCmd = {
+    name: 'init',
+    // Re-use the sync command's i18n bundle so messages stay in lockstep.
+    messages: syncMessages,
+    summary: () => t('repo.sync.summary'),
+    describe: () => t('repo.sync.description'),
+    args: [{ flag: '[path]', describe: () => t('repo.sync.arg.path') }],
+    options: [
+        {
+            flags: '--lang <lang>',
+            describe: () => t('opt.lang'),
+            choices: ['zh-CN', 'en-US', 'zh', 'en'],
+        },
+        { flags: '--force', describe: () => t('repo.sync.opt.force') },
+        { flags: '--dry-run', describe: () => t('opt.dryRun') },
+    ],
+    examples: () => [
+        { command: 'qtype init', describe: () => t('repo.sync.example.dryRun') },
+        { command: 'qtype init ./my-material --force', describe: () => t('repo.sync.example.force') },
+    ],
+    seeAlso: ['repo new', 'repo sync', 'publish init'],
+    action: async (pathArg, opts) => {
+        warnIfHome(pathArg ?? process.cwd());
+        const userDefault = (await userKv.get('repo.lang'));
+        const lang = opts.lang ?? userDefault ?? getLocale();
+        await repoSyncAction({
+            path: pathArg,
+            lang,
+            force: opts.force === true,
+            dryRun: opts.dryRun === true,
+        });
+    },
+};

package/dist/cli/commands/pack/i18n.js

@@ -0,0 +1,20 @@
+export const messages = {
+    'zh-CN': {
+        'pack.summary': '打包资料仓库',
+        'pack.description': '把当前目录的资料打成 tar.gz 便于分享（忽略 dist/、node_modules/、.git/）',
+        'pack.opt.out': '输出文件（默认 <目录名>.tar.gz）',
+        'pack.err.noMaterial': '当前目录不像 qtype 资料（未找到 material/）。先跑 `qtype init`。',
+        'pack.err.tar': '打包失败：{msg}',
+        'pack.msg.packing': '打包中 → {path}',
+        'pack.msg.done': '已打包 → {path}',
+    },
+    'en-US': {
+        'pack.summary': 'Bundle a material repo',
+        'pack.description': 'Pack the current material repo into a tar.gz for sharing (excludes dist/, node_modules/, .git/)',
+        'pack.opt.out': 'Output file (default: <dirname>.tar.gz)',
+        'pack.err.noMaterial': 'Current directory is not a qtype repo (no material/). Run `qtype init` first.',
+        'pack.err.tar': 'Pack failed: {msg}',
+        'pack.msg.packing': 'Packing → {path}',
+        'pack.msg.done': 'Packed → {path}',
+    },
+};

package/dist/cli/commands/pack/index.js

@@ -0,0 +1,48 @@
+/**
+ * `qtype pack` — bundle the current material repo into a tar.gz for sharing.
+ *
+ * Simple wrapper over `tar -czf`. Ignores dist/, node_modules/, .git/ and any
+ * pre-existing tarballs so re-running is idempotent.
+ */
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { t } from '../../i18n/index.js';
+import { error, info, success } from '../../utils/output.js';
+import { messages } from './i18n.js';
+const IGNORE = new Set(['dist', 'node_modules', '.git']);
+export const packCmd = {
+    name: 'pack',
+    messages,
+    summary: () => t('pack.summary'),
+    describe: () => t('pack.description'),
+    options: [
+        { flags: '-o, --out <file>', describe: () => t('pack.opt.out') },
+    ],
+    action: async (opts) => {
+        const cwd = process.cwd();
+        if (!fs.existsSync(path.join(cwd, 'material'))) {
+            error(t('pack.err.noMaterial'));
+            process.exitCode = 1;
+            return;
+        }
+        const name = path.basename(cwd);
+        const outFile = path.resolve(cwd, opts.out ?? `${name}.tar.gz`);
+        const entries = fs
+            .readdirSync(cwd)
+            .filter((n) => !IGNORE.has(n) && !n.endsWith('.tar.gz'));
+        info(t('pack.msg.packing', { path: outFile }));
+        const res = spawnSync('tar', ['-czf', outFile, ...entries], {
+            cwd,
+            stdio: 'inherit',
+        });
+        if (res.status !== 0) {
+            error(t('pack.err.tar', {
+                msg: res.error?.message ?? `exit ${res.status}`,
+            }));
+            process.exitCode = 1;
+            return;
+        }
+        success(t('pack.msg.done', { path: outFile }));
+    },
+};

package/dist/cli/commands/plugin/i18n.js

@@ -0,0 +1,28 @@
+export const messages = {
+    'zh-CN': {
+        'plugin.summary': '插件管理',
+        'plugin.description': '管理 qtype 插件：列表 / 启用 / 禁用（骨架，暂未接入插件系统）',
+        'plugin.list.summary': '列出插件',
+        'plugin.list.description': '列出所有已注册的插件及其状态',
+        'plugin.enable.summary': '启用插件',
+        'plugin.enable.description': '启用一个已注册的插件',
+        'plugin.disable.summary': '禁用插件',
+        'plugin.disable.description': '禁用一个已启用的插件',
+        'plugin.msg.noPlugins': '没有已注册的插件',
+        'plugin.msg.notImplemented': '插件系统尚未实现（qtype {phase}）',
+        'plugin.msg.notFound': '插件不存在：{id}',
+    },
+    'en-US': {
+        'plugin.summary': 'Plugin management',
+        'plugin.description': 'Manage qtype plugins: list / enable / disable (skeleton, plugin system not yet wired)',
+        'plugin.list.summary': 'List plugins',
+        'plugin.list.description': 'List all registered plugins and their status',
+        'plugin.enable.summary': 'Enable plugin',
+        'plugin.enable.description': 'Enable a registered plugin',
+        'plugin.disable.summary': 'Disable plugin',
+        'plugin.disable.description': 'Disable an enabled plugin',
+        'plugin.msg.noPlugins': 'No plugins registered',
+        'plugin.msg.notImplemented': 'Plugin system not yet implemented (qtype {phase})',
+        'plugin.msg.notFound': 'Plugin not found: {id}',
+    },
+};