@ysk-kit/cli 1.0.0

package/dist/check-agent.d.ts

@@ -0,0 +1,9 @@
+export type AgentFinding = {
+    rule: 'no-ts-enum' | 'clients-no-prisma' | 'clients-no-raw-fetch';
+    file: string;
+    line: number;
+};
+export declare const RAW_FETCH_ALLOWLIST: Set<string>;
+export declare const checkAgent: (productRoot: string) => AgentFinding[];
+export declare const formatAgentFindings: (findings: AgentFinding[]) => string;
+//# sourceMappingURL=check-agent.d.ts.map

package/dist/check-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-agent.d.ts","sourceRoot":"","sources":["../src/check-agent.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,YAAY,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAgBF,eAAO,MAAM,mBAAmB,aAA8D,CAAC;AAyC/F,eAAO,MAAM,UAAU,GAAI,aAAa,MAAM,KAAG,YAAY,EA+B5D,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,UAAU,YAAY,EAAE,KAAG,MAI9D,CAAC"}

package/dist/check-agent.js

@@ -0,0 +1,85 @@
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+const SKIP_DIRS = new Set([
+    'node_modules',
+    'dist',
+    'generated',
+    'coverage',
+    '.git',
+    '.turbo',
+    '.expo',
+]);
+const SCAN_ROOTS = ['apps', 'packages', 'modules'];
+const CLIENT_PREFIXES = ['apps/web/', 'apps/admin/', 'apps/mobile/', 'apps/desktop/'];
+export const RAW_FETCH_ALLOWLIST = new Set(['apps/admin/src/features/queues/queues-page.tsx']);
+const ENUM_RE = /\b(?:const\s+)?enum\s+[A-Za-z_][\w]*\s*\{/;
+const PRISMA_RE = /@prisma\/client|@ysk-kit\/db-prisma|apps\/api\/src\/generated|generated\/prisma/;
+const FETCH_RE = /\bfetch\s*\(/;
+const toPosix = (rel) => rel.split(sep).join('/');
+const isSourceFile = (name) => {
+    if (name.endsWith('.d.ts'))
+        return false;
+    if (name.endsWith('.test.ts') || name.endsWith('.test.tsx'))
+        return false;
+    return name.endsWith('.ts') || name.endsWith('.tsx');
+};
+const isCommentLine = (line) => {
+    const trimmed = line.trim();
+    return (trimmed.startsWith('//') ||
+        trimmed.startsWith('*') ||
+        trimmed.startsWith('/*') ||
+        trimmed.startsWith('*/'));
+};
+const isClientFile = (rel) => CLIENT_PREFIXES.some((prefix) => rel.startsWith(prefix));
+const walk = (dir, files) => {
+    if (!existsSync(dir))
+        return;
+    for (const entry of readdirSync(dir)) {
+        if (SKIP_DIRS.has(entry))
+            continue;
+        const path = join(dir, entry);
+        const stat = statSync(path);
+        if (stat.isDirectory()) {
+            walk(path, files);
+            continue;
+        }
+        if (isSourceFile(entry))
+            files.push(path);
+    }
+};
+export const checkAgent = (productRoot) => {
+    const files = [];
+    for (const root of SCAN_ROOTS) {
+        walk(join(productRoot, root), files);
+    }
+    const findings = [];
+    for (const abs of files) {
+        const file = toPosix(relative(productRoot, abs));
+        const client = isClientFile(file);
+        const lines = readFileSync(abs, 'utf8').split(/\r?\n/);
+        for (let i = 0; i < lines.length; i += 1) {
+            const line = lines[i] ?? '';
+            if (isCommentLine(line))
+                continue;
+            const at = i + 1;
+            if (ENUM_RE.test(line)) {
+                findings.push({ rule: 'no-ts-enum', file, line: at });
+            }
+            if (client && PRISMA_RE.test(line)) {
+                findings.push({ rule: 'clients-no-prisma', file, line: at });
+            }
+            if (client && FETCH_RE.test(line) && !RAW_FETCH_ALLOWLIST.has(file)) {
+                findings.push({ rule: 'clients-no-raw-fetch', file, line: at });
+            }
+        }
+    }
+    findings.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line || a.rule.localeCompare(b.rule));
+    return findings;
+};
+export const formatAgentFindings = (findings) => {
+    if (findings.length === 0)
+        return 'ysk check agent: ok';
+    const width = Math.max(...findings.map((item) => item.rule.length));
+    return findings.map((item) => `${item.rule.padEnd(width)}  ${item.file}:${item.line}`).join('\n');
+};
+//# sourceMappingURL=check-agent.js.map

package/dist/check-agent.js.map

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

package/dist/generate-openapi.d.ts

@@ -0,0 +1,2 @@
+export declare const generateOpenApi: (root: string) => string;
+//# sourceMappingURL=generate-openapi.d.ts.map

package/dist/generate-openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-openapi.d.ts","sourceRoot":"","sources":["../src/generate-openapi.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAM9C,CAAC"}

package/dist/generate-openapi.js

@@ -0,0 +1,52 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { buildOpenApiDocument } from '@ysk-kit/api-http';
+import { appContract } from '@ysk-kit/contracts';
+export const generateOpenApi = (root) => {
+    const spec = buildOpenApiDocument(appContract);
+    const out = join(root, 'docs/openapi.yaml');
+    mkdirSync(dirname(out), { recursive: true });
+    writeFileSync(out, stringifyYaml(spec));
+    return out;
+};
+const stringifyYaml = (value, indent = 0) => {
+    const pad = '  '.repeat(indent);
+    if (value === null || value === undefined)
+        return 'null';
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        return value
+            .map((item) => {
+            if (item && typeof item === 'object') {
+                const body = stringifyYaml(item, indent + 1);
+                return `${pad}- ${body.trimStart()}`;
+            }
+            return `${pad}- ${stringifyYaml(item)}`;
+        })
+            .join('\n');
+    }
+    if (typeof value === 'object') {
+        const entries = Object.entries(value);
+        if (entries.length === 0)
+            return '{}';
+        return entries
+            .map(([k, v]) => {
+            const nested = stringifyYaml(v, indent + 1);
+            if (v && typeof v === 'object' && !Array.isArray(v)) {
+                return `${pad}${k}:\n${nested}`;
+            }
+            if (Array.isArray(v) && v.length > 0 && typeof v[0] === 'object') {
+                return `${pad}${k}:\n${nested}`;
+            }
+            return `${pad}${k}: ${nested}`;
+        })
+            .join('\n');
+    }
+    return JSON.stringify(value);
+};
+//# sourceMappingURL=generate-openapi.js.map

package/dist/generate-openapi.js.map

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

package/dist/help.d.ts

@@ -0,0 +1,2 @@
+export declare const HELP: string;
+//# sourceMappingURL=help.d.ts.map

package/dist/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,QAmDhB,CAAC"}

package/dist/help.js

@@ -0,0 +1,54 @@
+import { CAPABILITIES } from './add-capability';
+export const HELP = `ysk — generator for YSK Kit products
+
+Usage:
+  pnpm ysk add module <kebab-name> [--prisma] [--web] [--no-web]
+  pnpm ysk add <capability>
+  pnpm ysk generate openapi
+  pnpm ysk upgrade [--dry-run]
+  pnpm ysk check agent
+
+Commands:
+  add module <name>
+      Scaffold one hexagonal HTTP slice: contract, DTO, memory + Prisma
+      repositories, Express + Fastify handlers, SDK resource, web-sdk hooks,
+      optional Vite page, and a memory-repo service test.
+      --prisma   Merge a title/body/authorId Prisma model (off by default)
+      --web      Write apps/web page (on by default)
+      --no-web   Skip the Vite page
+      Name must be kebab-case (booking, inventory-item). Path is /v1/<name>.
+
+  add <capability>
+      Merge a catalogued platform capability into the product root.
+      Capabilities: ${CAPABILITIES.join(', ')}
+      Alias: org → team
+      billing requires team (Organization model) first.
+      llm, team, billing, and push copy source trees when the product does
+      not already wire them. A second run is a no-op.
+
+  generate openapi
+      Write docs/openapi.yaml from the ts-rest app contract.
+
+  upgrade [--dry-run]
+      Copy allowlisted guardrail files from this kit checkout into the
+      product root (YSK_ROOT). Overwrites AGENTS.md, skills, TypeScript
+      and Biome config, and dependency-cruiser. Workspace products also
+      receive generated Cursor/Grok skill wrappers (gitignored). Does
+      not touch apps, modules, product README, .env, or Prisma.
+      --dry-run   List will copy / skip without writing
+
+  check agent
+      Scan the product root for typical broken patches: TypeScript enum,
+      Prisma imports in web/admin/mobile/desktop, and raw fetch in those
+      apps. Prints rule id + file:line. Exit 1 when anything matches.
+
+Environment:
+  YSK_ROOT    Product root to patch (default: this repository)
+
+After add module / add capability:
+  pnpm db:migrate && pnpm gen:openapi && pnpm layers && pnpm typecheck && pnpm test && pnpm ysk check agent
+
+Manual: docs/cli/ysk.md
+Chinese: docs/cli/ysk.zh.md
+`;
+//# sourceMappingURL=help.js.map

package/dist/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,CAAC,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;sBAqBE,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B5C,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,59 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { addCapability } from './add-capability';
+import { addModule } from './add-module';
+import { checkAgent, formatAgentFindings } from './check-agent';
+import { generateOpenApi } from './generate-openapi';
+import { HELP } from './help';
+import { upgrade } from './upgrade';
+const args = process.argv.slice(2);
+const kitRoot = resolve(dirname(fileURLToPath(import.meta.url)), '../../..');
+const root = resolve(process.env.YSK_ROOT ?? kitRoot);
+const help = () => {
+    console.log(HELP);
+};
+try {
+    if (args[0] === 'add' && args[1] && args[1] !== 'module') {
+        const logs = addCapability(args[1], root);
+        for (const line of logs)
+            console.log(line);
+        process.exit(0);
+    }
+    if (args[0] === 'add' && args[1] === 'module' && args[2]) {
+        const name = args[2];
+        const logs = addModule(root, name, {
+            prisma: args.includes('--prisma'),
+            web: args.includes('--web') || !args.includes('--no-web'),
+        });
+        for (const line of logs)
+            console.log(line);
+        process.exit(0);
+    }
+    if (args[0] === 'generate' && args[1] === 'openapi') {
+        const out = generateOpenApi(root);
+        console.log(`wrote ${out}`);
+        process.exit(0);
+    }
+    if (args[0] === 'check' && args[1] === 'agent') {
+        const findings = checkAgent(root);
+        console.log(formatAgentFindings(findings));
+        process.exit(findings.length === 0 ? 0 : 1);
+    }
+    if (args[0] === 'upgrade') {
+        const logs = upgrade({
+            productRoot: root,
+            kitRoot,
+            dryRun: args.includes('--dry-run'),
+        });
+        for (const line of logs)
+            console.log(line);
+        process.exit(0);
+    }
+    help();
+    process.exit(args.length === 0 ? 0 : 1);
+}
+catch (error) {
+    console.error(error instanceof Error ? error.message : error);
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/merge-prisma.d.ts

@@ -0,0 +1,15 @@
+export type PrismaBlock = {
+    name: string;
+    block: string;
+};
+export type PrismaMergeOpts = {
+    userFields?: string[];
+    organizationFields?: string[];
+};
+export declare const extractEnums: (fragment: string) => PrismaBlock[];
+export declare const extractModels: (fragment: string) => PrismaBlock[];
+export declare const mergePrisma: (schema: string, fragment: string, opts?: PrismaMergeOpts) => {
+    schema: string;
+    actions: string[];
+};
+//# sourceMappingURL=merge-prisma.d.ts.map

package/dist/merge-prisma.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-prisma.d.ts","sourceRoot":"","sources":["../src/merge-prisma.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,UAAU,MAAM,KAAG,WAAW,EAS1D,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG,WAAW,EAS3D,CAAC;AA0CF,eAAO,MAAM,WAAW,GACtB,QAAQ,MAAM,EACd,UAAU,MAAM,EAChB,OAAM,eAAoB,KACzB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAuCrC,CAAC"}

package/dist/merge-prisma.js

@@ -0,0 +1,90 @@
+export const extractEnums = (fragment) => {
+    const blocks = [];
+    const re = /enum\s+(\w+)\s*\{[^}]*\}/g;
+    let match = re.exec(fragment);
+    while (match) {
+        blocks.push({ name: match[1] ?? '', block: match[0].trim() });
+        match = re.exec(fragment);
+    }
+    return blocks;
+};
+export const extractModels = (fragment) => {
+    const blocks = [];
+    const re = /model\s+(\w+)\s*\{[\s\S]*?\n\}/g;
+    let match = re.exec(fragment);
+    while (match) {
+        blocks.push({ name: match[1] ?? '', block: match[0].trim() });
+        match = re.exec(fragment);
+    }
+    return blocks;
+};
+const hasEnum = (schema, name) => new RegExp(`enum\\s+${name}\\s*\\{`).test(schema);
+const hasModel = (schema, name) => new RegExp(`model\\s+${name}\\s*\\{`).test(schema);
+const ensureModelFields = (schema, model, fields, actions) => {
+    if (fields.length === 0)
+        return schema;
+    const header = schema.match(new RegExp(`model\\s+${model}\\s*\\{`));
+    if (!header || header.index === undefined) {
+        actions.push(`skipped ${model} fields (no model ${model})`);
+        return schema;
+    }
+    const start = header.index + header[0].length;
+    const end = schema.indexOf('\n}', start);
+    if (end < 0) {
+        actions.push(`skipped ${model} fields (unterminated model ${model})`);
+        return schema;
+    }
+    const body = schema.slice(start, end);
+    const extra = [];
+    for (const field of fields) {
+        const name = field.trim().split(/\s+/)[0];
+        if (!name)
+            continue;
+        if (body.includes(name)) {
+            actions.push(`skipped field ${model}.${name}`);
+        }
+        else {
+            extra.push(`  ${field.trim()}`);
+            actions.push(`added field ${model}.${name}`);
+        }
+    }
+    if (extra.length === 0)
+        return schema;
+    return `${schema.slice(0, end)}\n${extra.join('\n')}${schema.slice(end)}`;
+};
+export const mergePrisma = (schema, fragment, opts = {}) => {
+    const actions = [];
+    let next = schema;
+    for (const item of extractEnums(fragment)) {
+        if (hasEnum(next, item.name)) {
+            actions.push(`skipped enum ${item.name}`);
+            continue;
+        }
+        const firstModel = next.search(/model\s+\w+/);
+        const at = firstModel >= 0 ? firstModel : next.length;
+        const prefix = next.slice(0, at);
+        const pad = prefix.endsWith('\n\n') || prefix.length === 0 ? '' : '\n';
+        next = `${prefix}${pad}${item.block}\n\n${next.slice(at)}`;
+        actions.push(`added enum ${item.name}`);
+    }
+    next = ensureModelFields(next, 'User', opts.userFields ?? [], actions);
+    next = ensureModelFields(next, 'Organization', opts.organizationFields ?? [], actions);
+    for (const item of extractModels(fragment)) {
+        if (item.name === 'User') {
+            actions.push('skipped model User');
+            continue;
+        }
+        if (hasModel(next, item.name)) {
+            actions.push(`skipped model ${item.name}`);
+            continue;
+        }
+        const pad = next.endsWith('\n') ? '' : '\n';
+        next = `${next}${pad}\n${item.block}\n`;
+        actions.push(`added model ${item.name}`);
+    }
+    if (/provider\s*=\s*"sqlite"/.test(next)) {
+        next = next.replace(/\s+@db\.[A-Za-z0-9(),]+/g, '');
+    }
+    return { schema: next, actions };
+};
+//# sourceMappingURL=merge-prisma.js.map

package/dist/merge-prisma.js.map

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

package/dist/patch-text.d.ts

@@ -0,0 +1,17 @@
+export declare const ensureEnvKey: (source: string, key: string) => {
+    source: string;
+    added: boolean;
+};
+export declare const ensureJsonDep: (json: string, name: string, spec: string) => {
+    source: string;
+    added: boolean;
+};
+export declare const insertAfterLastImport: (source: string, statement: string) => string;
+export declare const EXPRESS_ERROR_HANDLER = "  app.use(errorHandler);";
+export declare const EXPRESS_RETURN_APP = "  return app;";
+/** Express only maps `next(error)` for routers registered before `errorHandler`. */
+export declare const expressRouteInsertBefore: (source: string) => string;
+export declare const ensureMarkerBlock: (source: string, name: string, body: string, insertBefore?: string) => string;
+export declare const insertBeforeMatch: (source: string, match: string, insert: string) => string;
+export declare const ensureNamedImport: (source: string, moduleName: string, names: string[]) => string;
+//# sourceMappingURL=patch-text.d.ts.map

package/dist/patch-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-text.d.ts","sourceRoot":"","sources":["../src/patch-text.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,EAAE,KAAK,MAAM,KAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAK1F,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,MAAM,MAAM,KACX;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAMlC,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,KAAG,MAYzE,CAAC;AAEF,eAAO,MAAM,qBAAqB,6BAA6B,CAAC;AAChE,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAElD,oFAAoF;AACpF,eAAO,MAAM,wBAAwB,GAAI,QAAQ,MAAM,KAAG,MAC2B,CAAC;AAEtF,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,eAAe,MAAM,KACpB,MASF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,MAKjF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,YAAY,MAAM,EAAE,OAAO,MAAM,EAAE,KAAG,MAiBvF,CAAC"}

package/dist/patch-text.js

@@ -0,0 +1,72 @@
+export const ensureEnvKey = (source, key) => {
+    const re = new RegExp(`^${key}=`, 'm');
+    if (re.test(source))
+        return { source, added: false };
+    const next = source.endsWith('\n') || source.length === 0 ? source : `${source}\n`;
+    return { source: `${next}${key}=\n`, added: true };
+};
+export const ensureJsonDep = (json, name, spec) => {
+    const pkg = JSON.parse(json);
+    pkg.dependencies ??= {};
+    if (pkg.dependencies[name])
+        return { source: json, added: false };
+    pkg.dependencies[name] = spec;
+    return { source: `${JSON.stringify(pkg, null, 2)}\n`, added: true };
+};
+export const insertAfterLastImport = (source, statement) => {
+    if (source.includes(statement.trim()))
+        return source;
+    const lines = source.split('\n');
+    let lastImport = -1;
+    for (let i = 0; i < lines.length; i += 1) {
+        if (lines[i]?.startsWith('import '))
+            lastImport = i;
+    }
+    if (lastImport < 0) {
+        return `${statement}\n${source}`;
+    }
+    lines.splice(lastImport + 1, 0, statement);
+    return lines.join('\n');
+};
+export const EXPRESS_ERROR_HANDLER = '  app.use(errorHandler);';
+export const EXPRESS_RETURN_APP = '  return app;';
+/** Express only maps `next(error)` for routers registered before `errorHandler`. */
+export const expressRouteInsertBefore = (source) => source.includes(EXPRESS_ERROR_HANDLER) ? EXPRESS_ERROR_HANDLER : EXPRESS_RETURN_APP;
+export const ensureMarkerBlock = (source, name, body, insertBefore) => {
+    const start = `// --- ysk-add:${name} ---`;
+    if (source.includes(start))
+        return source;
+    const block = `${start}\n${body}\n// --- ysk-add:${name}:end ---`;
+    if (insertBefore && source.includes(insertBefore)) {
+        return source.replace(insertBefore, `${block}\n${insertBefore}`);
+    }
+    const next = source.endsWith('\n') ? source : `${source}\n`;
+    return `${next}${block}\n`;
+};
+export const insertBeforeMatch = (source, match, insert) => {
+    if (source.includes(insert.trim()))
+        return source;
+    const index = source.indexOf(match);
+    if (index < 0)
+        return source;
+    return `${source.slice(0, index)}${insert}${source.slice(index)}`;
+};
+export const ensureNamedImport = (source, moduleName, names) => {
+    const escaped = moduleName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp(`import\\s+(type\\s+)?\\{([^}]*)\\}\\s+from\\s+['"]${escaped}['"]`);
+    const match = re.exec(source);
+    if (!match || match.index === undefined) {
+        return insertAfterLastImport(source, `import { ${names.join(', ')} } from '${moduleName}';`);
+    }
+    const existing = (match[2] ?? '')
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+    const hasName = (name) => existing.some((item) => item === name || item === `type ${name}` || item.endsWith(` ${name}`));
+    const missing = names.filter((name) => !hasName(name));
+    if (missing.length === 0)
+        return source;
+    const rebuilt = `import ${match[1] ?? ''}{ ${[...existing, ...missing].join(', ')} } from '${moduleName}'`;
+    return `${source.slice(0, match.index)}${rebuilt}${source.slice(match.index + match[0].length)}`;
+};
+//# sourceMappingURL=patch-text.js.map

package/dist/patch-text.js.map

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

package/dist/upgrade.d.ts

@@ -0,0 +1,16 @@
+export declare const UPGRADE_PATHS: readonly ["AGENTS.md", "AGENTS.zh.md", "CLAUDE.md", ".dependency-cruiser.cjs", "packages/typescript-config", "packages/biome-config", "docs/skills"];
+export type YskKitMarker = {
+    kit: string;
+    version: string;
+    flavor: string;
+    preset: string;
+    db: string;
+};
+export type UpgradeOptions = {
+    productRoot: string;
+    kitRoot: string;
+    dryRun: boolean;
+};
+export declare const readKitVersion: (kitRoot: string) => string;
+export declare const upgrade: (opts: UpgradeOptions) => string[];
+//# sourceMappingURL=upgrade.d.ts.map

package/dist/upgrade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,aAAa,sJAQhB,CAAC;AAIX,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,KAAG,MAMhD,CAAC;AA2CF,eAAO,MAAM,OAAO,GAAI,MAAM,cAAc,KAAG,MAAM,EAsDpD,CAAC"}