@danceiny/gotry 0.0.1-rc.14 → 0.0.1-rc.16

package/dist/scripts/build-changelog.js

@@ -0,0 +1,279 @@
+import { execFileSync } from 'node:child_process';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const TYPE_TO_KEEP_A_CHANGELOG = {
+    feat: 'Added',
+    fix: 'Fixed',
+    perf: 'Changed',
+    refactor: 'Changed',
+    docs: 'Documentation',
+    test: 'Tests',
+    build: 'Build',
+    ci: 'CI',
+    chore: 'Chore',
+    revert: 'Reverted'
+};
+const DISPLAY_ORDER = [
+    'feat',
+    'fix',
+    'perf',
+    'refactor',
+    'revert',
+    'docs',
+    'test',
+    'build',
+    'ci',
+    'chore',
+    'other'
+];
+const CONVENTIONAL_RE = /^(feat|fix|perf|refactor|docs|test|build|ci|chore|revert)(?:\(([^)]+)\))?(!)?:\s*(.+)$/;
+export function parseCommit(raw) {
+    const lines = raw.split('\n');
+    const firstLine = lines[0] ?? '';
+    if (!firstLine) return null;
+    const { head, prRef } = splitSubjectAndPr(firstLine);
+    const match = head.match(CONVENTIONAL_RE);
+    if (!match) {
+        return {
+            sha: '',
+            type: 'other',
+            scope: null,
+            subject: head,
+            prRef,
+            raw
+        };
+    }
+    const [, type, scope] = match;
+    const colonIdx = head.indexOf(': ');
+    const subject = colonIdx >= 0 ? head.slice(colonIdx + 2).trim() : head;
+    return {
+        sha: '',
+        type: type,
+        scope: scope ?? null,
+        subject,
+        prRef,
+        raw
+    };
+}
+function splitSubjectAndPr(text) {
+    const m = text.match(/\s+\(#(\d+)\)\s*$/);
+    if (m) return {
+        head: text.slice(0, m.index).trim(),
+        prRef: m[1]
+    };
+    return {
+        head: text.trim(),
+        prRef: null
+    };
+}
+function extractPrRef(text) {
+    const m = text.match(/\(#(\d+)\)/);
+    return m ? m[1] : null;
+}
+export function listCommits(opts) {
+    const args = [
+        'log',
+        '--no-merges',
+        '--pretty=format:%H%x00%s%x00%b%x00%x1e'
+    ];
+    if (opts.since) args.push(`${opts.since}..HEAD`);
+    const out = execFileSync('git', args, {
+        cwd: opts.cwd,
+        encoding: 'utf8'
+    });
+    if (!out) return [];
+    return out.split('\u001e').filter(Boolean).map((raw)=>{
+        const [sha, subject, body] = raw.split('\u0000').map((s)=>(s ?? '').trim());
+        return {
+            sha: sha ?? '',
+            subject: subject ?? '',
+            body: body ?? ''
+        };
+    });
+}
+export function groupCommits(commits) {
+    const sections = new Map();
+    for (const c of commits){
+        if (!sections.has(c.type)) sections.set(c.type, {
+            type: c.type,
+            items: []
+        });
+        sections.get(c.type).items.push({
+            subject: c.subject,
+            sha: c.sha,
+            prRef: c.prRef
+        });
+    }
+    const out = [];
+    for (const t of DISPLAY_ORDER){
+        const sec = sections.get(t);
+        if (sec && sec.items.length > 0) out.push(sec);
+    }
+    return out;
+}
+export function renderMarkdownEntry(entry) {
+    const lines = [];
+    lines.push(`## [${entry.version}] - ${entry.date}`);
+    lines.push('');
+    for (const sec of entry.sections){
+        const header = sec.type === 'other' ? 'Other' : TYPE_TO_KEEP_A_CHANGELOG[sec.type] ?? sec.type;
+        lines.push(`### ${header}`);
+        lines.push('');
+        for (const item of sec.items){
+            const subject = truncateSubject(item.subject, 120);
+            const suffix = item.prRef ? ` (#${item.prRef})` : item.sha ? ` (${item.sha.slice(0, 7)})` : '';
+            lines.push(`- ${subject}${suffix}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function truncateSubject(text, max) {
+    if (text.length <= max * 2) {
+        const breakers = [
+            '。',
+            '——',
+            '; ',
+            ' — ',
+            ',',
+            '，'
+        ];
+        for (const b of breakers){
+            const i = text.indexOf(b);
+            if (i > 30 && i <= max * 2) return `${text.slice(0, i).trim()}…`;
+        }
+    }
+    return `${text.slice(0, max).trim()}…`;
+}
+export function buildEntry(opts) {
+    return {
+        version: opts.version,
+        date: opts.date,
+        sections: groupCommits(opts.commits)
+    };
+}
+const CHANGELOG_HEADER = `# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+`;
+export function splitChangelog(raw) {
+    const firstSection = raw.indexOf('\n## [');
+    if (firstSection < 0) return {
+        preamble: raw.endsWith('\n') ? raw : `${raw}\n`,
+        history: []
+    };
+    const preamble = raw.slice(0, firstSection + 1);
+    const history = raw.slice(firstSection + 1);
+    return {
+        preamble,
+        history: [
+            history
+        ]
+    };
+}
+export function prependEntry(raw, entryMarkdown) {
+    if (!existsSync(join('..', 'CHANGELOG.md')) && !raw) {
+        return CHANGELOG_HEADER + entryMarkdown;
+    }
+    const split = splitChangelog(raw || CHANGELOG_HEADER + '');
+    return split.preamble + entryMarkdown + '\n' + split.history.join('').replace(/^\n/, '');
+}
+function arg(name) {
+    const i = process.argv.indexOf(name);
+    return i >= 0 ? process.argv[i + 1] : undefined;
+}
+function readPackageVersion() {
+    const raw = JSON.parse(readFileSync(join('..', 'package.json'), 'utf8'));
+    if (!raw.version) throw new Error('package.json 缺 version 字段');
+    return raw.version;
+}
+function gitHeadSha() {
+    return execFileSync('git', [
+        'rev-parse',
+        'HEAD'
+    ], {
+        encoding: 'utf8'
+    }).trim();
+}
+export function buildFromGit(opts) {
+    const rawCommits = listCommits({
+        cwd: opts.cwd,
+        since: opts.since
+    });
+    const parsed = [];
+    for (const r of rawCommits){
+        const m = parseCommit(r.subject);
+        if (!m) continue;
+        m.sha = r.sha;
+        m.raw = r.body;
+        parsed.push(m);
+    }
+    const entry = buildEntry({
+        version: opts.version,
+        date: opts.date,
+        commits: parsed
+    });
+    const markdown = renderMarkdownEntry(entry);
+    return {
+        entry,
+        markdown
+    };
+}
+async function main() {
+    const cwd = join('..');
+    const version = arg('--version') ?? readPackageVersion();
+    const date = arg('--date') ?? new Date().toISOString().slice(0, 10);
+    const since = arg('--since');
+    const write = process.argv.includes('--write');
+    let sinceTag = since;
+    if (!sinceTag) {
+        const out = execFileSync('git', [
+            'tag',
+            '-l',
+            'v*',
+            '--sort=-v:refname'
+        ], {
+            cwd,
+            encoding: 'utf8'
+        });
+        const tags = out.split('\n').map((t)=>t.trim()).filter(Boolean);
+        sinceTag = tags.find((t)=>t !== `v${version}` && tagsAreLessThan(t, `v${version}`)) ?? tags[tags.length - 1];
+    }
+    if (!sinceTag) {
+        console.error('build-changelog: 找不到起始 tag;传 --since <tag> 显式指定');
+        process.exit(2);
+    }
+    const { entry, markdown } = buildFromGit({
+        cwd,
+        version,
+        date,
+        since: sinceTag
+    });
+    const existing = existsSync(join(cwd, 'CHANGELOG.md')) ? readFileSync(join(cwd, 'CHANGELOG.md'), 'utf8') : '';
+    const next = write ? prependEntry(existing, markdown) : markdown;
+    console.log(`# build-changelog: ${entry.sections.length} sections / ${entry.sections.reduce((n, s)=>n + s.items.length, 0)} commits since ${sinceTag}`);
+    for (const sec of entry.sections){
+        console.log(`## ${sec.type} (${sec.items.length})`);
+        for (const it of sec.items)console.log(`  - ${it.subject}${it.prRef ? ` (#${it.prRef})` : ''}`);
+    }
+    if (write) {
+        writeFileSync(join(cwd, 'CHANGELOG.md'), next, 'utf8');
+        console.log(`\n>> wrote CHANGELOG.md (${next.length}B) @ ${gitHeadSha().slice(0, 7)}`);
+    }
+}
+function tagsAreLessThan(a, b) {
+    return a < b;
+}
+if (process.argv[1]?.endsWith('build-changelog.ts')) {
+    main().catch((e)=>{
+        console.error(`build-changelog error: ${e.message}`);
+        process.exit(1);
+    });
+}
+
+
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/scripts/build-changelog.ts

package/dist/scripts/changelog-tests.js

@@ -0,0 +1,165 @@
+import assert from 'node:assert/strict';
+import { buildEntry, groupCommits, parseCommit, prependEntry, renderMarkdownEntry, splitChangelog } from './build-changelog.js';
+let passed = 0;
+function ok(label) {
+    passed += 1;
+    console.log(`  ok ${label}`);
+}
+const sample = parseCommit('feat(cost): 价表 provider-aware v2 + 价格漂移监测 (#68)');
+assert.ok(sample);
+assert.equal(sample.type, 'feat');
+assert.equal(sample.scope, 'cost');
+assert.equal(sample.subject, '价表 provider-aware v2 + 价格漂移监测');
+assert.equal(sample.prRef, '68');
+ok('parseCommit feat(scope)! + #PR');
+const noScope = parseCommit('fix: 修复登录页可见性');
+assert.equal(noScope.type, 'fix');
+assert.equal(noScope.scope, null);
+assert.equal(noScope.subject, '修复登录页可见性');
+assert.equal(noScope.prRef, null);
+ok('parseCommit fix 无 scope');
+const other = parseCommit('docs: README 更新');
+assert.equal(other.type, 'docs');
+const legacy = parseCommit('feat(issue #21 P3.6): 会话扩展 onboarding UX 闭环(点点点 + 装完零重跑)');
+assert.equal(legacy.type, 'feat');
+assert.equal(legacy.scope, 'issue #21 P3.6');
+const historical = parseCommit('Merge branch main into feat/x');
+assert.equal(historical.type, 'other');
+assert.equal(historical.subject, 'Merge branch main into feat/x');
+ok('parseCommit 历史 commit + 中文 subject + 无 #PR 兼容');
+for (const t of [
+    'perf',
+    'refactor',
+    'docs',
+    'test',
+    'build',
+    'ci',
+    'chore',
+    'revert'
+]){
+    const p = parseCommit(`${t}: 一些改动`);
+    assert.equal(p.type, t);
+}
+ok('parseCommit 全 9 类型支持');
+const commits = [
+    {
+        sha: 'aaa',
+        type: 'fix',
+        scope: null,
+        subject: 'fix bug',
+        prRef: '1',
+        raw: ''
+    },
+    {
+        sha: 'bbb',
+        type: 'feat',
+        scope: null,
+        subject: 'add feature',
+        prRef: '2',
+        raw: ''
+    },
+    {
+        sha: 'ccc',
+        type: 'docs',
+        scope: null,
+        subject: 'update docs',
+        prRef: null,
+        raw: ''
+    },
+    {
+        sha: 'ddd',
+        type: 'other',
+        scope: null,
+        subject: 'random commit',
+        prRef: null,
+        raw: ''
+    }
+];
+const grouped = groupCommits(commits);
+assert.equal(grouped.length, 4);
+assert.equal(grouped[0].type, 'feat');
+assert.equal(grouped[1].type, 'fix');
+assert.equal(grouped[2].type, 'docs');
+assert.equal(grouped[3].type, 'other');
+ok('groupCommits Keep a Changelog 显示顺序(Added → Fixed → Documentation → Other)');
+const entry = buildEntry({
+    version: '0.0.1-rc.16',
+    date: '2026-08-30',
+    commits: [
+        {
+            sha: 'aaa',
+            type: 'feat',
+            scope: null,
+            subject: 'add a brand new feature with substantial description text',
+            prRef: '2',
+            raw: ''
+        },
+        {
+            sha: 'bbb',
+            type: 'fix',
+            scope: null,
+            subject: 'fix a critical bug in the rendering path of the parser',
+            prRef: '1',
+            raw: ''
+        },
+        {
+            sha: 'ccc',
+            type: 'docs',
+            scope: null,
+            subject: 'update the documentation for the new auth module',
+            prRef: null,
+            raw: ''
+        }
+    ]
+});
+const md = renderMarkdownEntry(entry);
+assert.match(md, /^## \[0\.0\.1-rc\.16\] - 2026-08-30/);
+assert.match(md, /### Added/);
+assert.match(md, /### Fixed/);
+assert.match(md, /### Documentation/);
+assert.match(md, /- add a brand new feature[^()]*\(#2\)/);
+assert.match(md, /- fix a critical bug[^()]*\(#1\)/);
+assert.match(md, /- update the documentation[^()]*\(ccc\)/);
+ok('renderMarkdownEntry 节结构 + PR/sha 后缀');
+const existing = `# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## [0.0.1-rc.15] - 2026-08-29
+
+### Added
+- 预订 saga 状态机
+`;
+const newMd = renderMarkdownEntry(entry);
+const next = prependEntry(existing, newMd);
+assert.match(next, /## \[0\.0\.1-rc\.16\] - 2026-08-30/);
+assert.match(next, /## \[0\.0\.1-rc\.15\] - 2026-08-29/);
+assert.match(next, /预订 saga 状态机/);
+ok('prependEntry:新版本段在顶部,历史段原样保留');
+const fromEmpty = prependEntry('', newMd);
+assert.match(fromEmpty, /Keep a Changelog/);
+assert.match(fromEmpty, /## \[0\.0\.1-rc\.16\]/);
+ok('prependEntry:空文件首次生成');
+const split = splitChangelog(existing);
+assert.ok(split.preamble.includes('All notable changes'));
+assert.ok(split.history[0].includes('## [0.0.1-rc.15]'));
+ok('splitChangelog preamble/history 分隔正确');
+const emptyEntry = buildEntry({
+    version: '0.0.1-rc.16',
+    date: '2026-08-30',
+    commits: []
+});
+const emptyMd = renderMarkdownEntry(emptyEntry);
+assert.match(emptyMd, /## \[0\.0\.1-rc\.16\]/);
+ok('buildEntry 空 commit 列表 → 仍输出版本头(0 section,合规)');
+const breaking = parseCommit('feat(api)!: 重命名端点 /v1/users → /v2/users (#99)');
+assert.equal(breaking.type, 'feat');
+assert.equal(breaking.subject, '重命名端点 /v1/users → /v2/users');
+assert.equal(breaking.prRef, '99');
+ok('parseCommit feat(scope)!: breaking change marker 容错');
+console.log(`changelog tests: ${passed} 组断言全绿(纯函数)`);
+
+
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/scripts/changelog-tests.ts

package/dist/scripts/companion-tests.js

@@ -109,4 +109,4 @@ pass('多人并存与 id 稳定性', ()=>{
 console.log(`\nCOMPANION TESTS: ${n}/4 OK(memory-design P2 守门面)`);
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/companion-tests.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/scripts/companion-tests.ts

package/dist/scripts/diff-test.js

@@ -36,4 +36,4 @@ for (const id of Object.keys(tsV)){
 console.log('\nDIFF TEST OK: 双路径判定一致(纯 TS,无 Python 依赖)');
 
 
-//# sourceURL=/Users/bytedance/work/gotry/ts/scripts/diff-test.ts
+//# sourceURL=/Users/bytedance/work/gotry-publish/ts/scripts/diff-test.ts