@shazhou/proman-core 0.9.0

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+## 0.9.0 — 2026-06-13
+
+- Refactor proman into a monorepo with `@shazhou/proman-core` and `@shazhou/proman` packages.
+  
+  **Breaking**: None - CLI interface remains unchanged
+  
+  **New packages**:
+  - `@shazhou/proman-core` - Core library with config loader, utils, and command logic as pure functions for programmatic use
+  - `@shazhou/proman` - CLI package that parses args and delegates to core functions
+  
+  **Features**:
+  - Proman now manages itself as a monorepo (dogfooding)
+  - Single-package projects work as one-package monorepos (eliminates need for unirepo support)
+  - Core exports are pure functions with no CLI-specific side effects
+  - Root `proman.yaml` configures packages array for monorepo management
+  
+  **Migration**: Users only need to upgrade the `@shazhou/proman` CLI package. The core package is automatically installed as a dependency.
+- Migrate tests from root to package-specific directories and fix monorepo dependencies
+  
+  - Migrate all test files from root `tests/` to `packages/core/tests/` and `packages/cli/tests/`
+  - Update test imports to reference correct package structure
+  - Remove `yaml` dependency from root package.json (now only in core package where it's used)
+  - Fix workflow schema test paths to reference root `.workflows/` directory
+

package/LICENSE

@@ -0,0 +1,18 @@
+MIT License
+
+Copyright (c) 2026 xiaoju
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and 
+associated documentation files (the "Software"), to deal in the Software without restriction, including 
+without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 
+copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the 
+following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial 
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT 
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO 
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE 
+USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/commands/bump.d.ts

@@ -0,0 +1,13 @@
+export type BumpOptions = {
+    type?: 'major' | 'minor' | 'patch';
+    cwd?: string;
+    now?: () => Date;
+};
+/**
+ * Bump package versions independently.
+ * --type: bump all packages with the given type.
+ * No --type: infer per-package bumps from changesets; only bump packages mentioned in changesets.
+ * Returns a map of package name → new version.
+ */
+export declare function bump(opts?: BumpOptions): Promise<Record<string, string>>;
+//# sourceMappingURL=bump.d.ts.map

package/dist/commands/bump.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bump.d.ts","sourceRoot":"","sources":["../../src/commands/bump.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB,CAAA;AA2BD;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAkFlF"}

package/dist/commands/bump.js

@@ -0,0 +1,115 @@
+import { readFile, stat, unlink, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { loadConfig } from '../config/load-config.js';
+import { buildChangelogEntry, prependChangelog, readChangesets, } from '../utils/changeset.js';
+import { bumpVersion, inferBump } from '../utils/version.js';
+async function readJson(path) {
+    const text = await readFile(path, 'utf8');
+    return JSON.parse(text);
+}
+async function writeJson(path, data) {
+    await writeFile(path, `${JSON.stringify(data, null, 2)}\n`);
+}
+function formatDate(d) {
+    const y = d.getUTCFullYear();
+    const m = String(d.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(d.getUTCDate()).padStart(2, '0');
+    return `${y}-${m}-${day}`;
+}
+async function fileExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Bump package versions independently.
+ * --type: bump all packages with the given type.
+ * No --type: infer per-package bumps from changesets; only bump packages mentioned in changesets.
+ * Returns a map of package name → new version.
+ */
+export async function bump(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const now = opts.now ?? (() => new Date());
+    const cfg = loadConfig(cwd);
+    const bumped = {};
+    if (opts.type) {
+        // Explicit --type: bump all packages
+        for (const pkg of cfg.packages) {
+            const pkgPath = resolve(cwd, pkg.path, 'package.json');
+            const json = await readJson(pkgPath);
+            const current = json.version;
+            if (!current)
+                throw new Error(`missing version in ${pkgPath}`);
+            const version = bumpVersion(current, opts.type);
+            json.version = version;
+            await writeJson(pkgPath, json);
+            bumped[pkg.name] = version;
+        }
+    }
+    else {
+        // Infer from changesets: per-package independent bump
+        const changesets = await readChangesets(cwd);
+        if (changesets.length === 0) {
+            throw new Error('no --type specified and no pending changesets found');
+        }
+        const bumpMap = inferBump(changesets);
+        if (Object.keys(bumpMap).length === 0) {
+            throw new Error('no inferable bump from changeset entries');
+        }
+        const pkgByName = new Map(cfg.packages.map((p) => [p.name, p]));
+        for (const [pkgName, bumpType] of Object.entries(bumpMap)) {
+            const pkg = pkgByName.get(pkgName);
+            if (!pkg)
+                continue; // changeset mentions unknown package, skip
+            const pkgPath = resolve(cwd, pkg.path, 'package.json');
+            const json = await readJson(pkgPath);
+            const current = json.version;
+            if (!current)
+                throw new Error(`missing version in ${pkgPath}`);
+            const version = bumpVersion(current, bumpType);
+            json.version = version;
+            await writeJson(pkgPath, json);
+            bumped[pkgName] = version;
+        }
+        // Generate CHANGELOG.md per bumped package
+        const date = formatDate(now());
+        const byPackage = {};
+        for (const cs of changesets) {
+            for (const pkg of Object.keys(cs.packages)) {
+                if (!pkgByName.has(pkg))
+                    continue;
+                const arr = byPackage[pkg] ?? [];
+                arr.push(cs);
+                byPackage[pkg] = arr;
+            }
+        }
+        for (const [pkgName, version] of Object.entries(bumped)) {
+            const list = byPackage[pkgName];
+            if (!list || list.length === 0)
+                continue;
+            const pkg = pkgByName.get(pkgName);
+            if (!pkg)
+                continue;
+            const entry = buildChangelogEntry({
+                version,
+                date,
+                bodies: list.map((c) => c.body),
+            });
+            const path = resolve(cwd, pkg.path, 'CHANGELOG.md');
+            let existing = null;
+            if (await fileExists(path)) {
+                existing = await readFile(path, 'utf8');
+            }
+            await writeFile(path, prependChangelog(existing, entry));
+        }
+        // Delete consumed changeset files
+        for (const cs of changesets) {
+            await unlink(cs.file);
+        }
+    }
+    return bumped;
+}

package/dist/commands/deploy.d.ts

@@ -0,0 +1,9 @@
+import { type SpawnFn } from '../utils/npm.js';
+export type DeployCommandOptions = {
+    cwd: string;
+    pkg?: string;
+    env?: string;
+    spawn?: SpawnFn;
+};
+export declare function deploy(opts: DeployCommandOptions): Promise<void>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/commands/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAExE,MAAM,MAAM,oBAAoB,GAAG;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAMD,wBAAsB,MAAM,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCtE"}

package/dist/commands/deploy.js

@@ -0,0 +1,42 @@
+import { resolve } from 'node:path';
+import { loadConfig } from '../config/index.js';
+import { defaultSpawn, runOrThrow } from '../utils/npm.js';
+function pnpmExec(bin, ...args) {
+    return ['pnpm', 'exec', bin, ...args];
+}
+export async function deploy(opts) {
+    const spawn = opts.spawn ?? defaultSpawn;
+    const cwd = resolve(opts.cwd);
+    const cfg = loadConfig(cwd);
+    let targets = cfg.packages;
+    if (opts.pkg !== undefined) {
+        const match = cfg.packages.find((p) => p.name === opts.pkg);
+        if (!match) {
+            throw new Error(`package not found: ${opts.pkg}`);
+        }
+        if (match.type !== 'webui' && match.type !== 'api') {
+            throw new Error(`package ${opts.pkg} (type=${match.type}) is not deployable; cannot deploy non-webui/api packages`);
+        }
+        targets = [match];
+    }
+    else {
+        targets = cfg.packages.filter((p) => p.type === 'webui' || p.type === 'api');
+    }
+    for (const pkg of targets) {
+        const pkgDir = resolve(cwd, pkg.path);
+        let argv;
+        if (pkg.type === 'webui') {
+            argv = pnpmExec('wrangler', 'pages', 'deploy', 'dist');
+        }
+        else if (pkg.type === 'api') {
+            argv = pnpmExec('wrangler', 'deploy');
+        }
+        else {
+            continue;
+        }
+        if (opts.env !== undefined) {
+            argv.push('--env', opts.env);
+        }
+        await runOrThrow(spawn, argv, pkgDir);
+    }
+}

package/dist/commands/dev.d.ts

@@ -0,0 +1,15 @@
+import { type SpawnFn } from '../utils/npm.js';
+export type DevCommandOptions = {
+    cwd: string;
+    spawn?: SpawnFn;
+    /** When provided, enables fingerprint caching.
+     *  - false: check fingerprint, skip if match
+     *  - true: always run (--force / CI)
+     *  - undefined: legacy behavior — always run, no fingerprint logic */
+    force?: boolean;
+};
+export declare function build(opts: DevCommandOptions): Promise<void>;
+export declare function runTests(opts: DevCommandOptions): Promise<void>;
+export declare function check(opts: DevCommandOptions): Promise<void>;
+export declare function format(opts: DevCommandOptions): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAUA,OAAO,EAA4B,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAExE,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;0EAGsE;IACtE,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAMD,wBAAsB,KAAK,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuElE;AAsBD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBrE;AAED,wBAAsB,KAAK,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBlE;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAInE"}

package/dist/commands/dev.js

@@ -0,0 +1,175 @@
+import { chmodSync, existsSync, readdirSync, readFileSync, rmSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { loadConfig } from '../config/index.js';
+import { computeBuildFingerprints, computeRootFingerprint, fingerprintPath, readFingerprint, writeFingerprint, } from '../utils/fingerprint.js';
+import { defaultSpawn, runOrThrow } from '../utils/npm.js';
+function pnpmExec(bin, ...args) {
+    return ['pnpm', 'exec', bin, ...args];
+}
+export async function build(opts) {
+    const spawn = opts.spawn ?? defaultSpawn;
+    const cwd = resolve(opts.cwd);
+    const cfg = loadConfig(cwd);
+    const useFingerprint = opts.force !== undefined;
+    const force = opts.force ?? false;
+    // Compute fingerprints only when fingerprint caching is enabled
+    const fingerprints = useFingerprint ? computeBuildFingerprints(cwd, cfg.packages) : null;
+    // Determine which packages to build
+    const toRun = [];
+    for (let i = 0; i < cfg.packages.length; i++) {
+        const pkg = cfg.packages[i];
+        const pkgDir = resolve(cwd, pkg.path);
+        const fpPath = fingerprintPath(pkgDir, 'build', pkg.name);
+        const fpValue = fingerprints?.get(pkg.name) ?? '';
+        if (useFingerprint && !force) {
+            const stored = readFingerprint(fpPath);
+            if (stored === fpValue) {
+                console.log(`⏭ build: ${pkg.name} (unchanged)`);
+                continue; // skip — fingerprint matches
+            }
+        }
+        toRun.push({ idx: i, pkgDir, fpPath, fpValue });
+    }
+    // Execute builds
+    for (const { idx, pkgDir } of toRun) {
+        const pkg = cfg.packages[idx];
+        // Clean output dir + tsbuildinfo before build to prevent stale artifacts.
+        // Note: since build fingerprints live inside dist/ (see fingerprintPath()),
+        // removing dist/ intentionally invalidates the build cache for this package.
+        const outDir = join(pkgDir, 'dist');
+        if (existsSync(outDir)) {
+            rmSync(outDir, { recursive: true });
+        }
+        const buildInfo = join(pkgDir, 'tsconfig.tsbuildinfo');
+        if (existsSync(buildInfo)) {
+            rmSync(buildInfo);
+        }
+        let argv;
+        switch (pkg.type) {
+            case 'webui':
+                argv = pnpmExec('vite', 'build');
+                break;
+            case 'cli':
+                // cli → use package's own build script (may be esbuild, tsc, etc.)
+                argv = ['pnpm', 'run', 'build'];
+                break;
+            default:
+                // lib | api → tsc --build
+                argv = pnpmExec('tsc', '--build');
+                break;
+        }
+        await runOrThrow(spawn, argv, pkgDir);
+        // chmod +x bin entries so linked CLIs survive tsc rebuild
+        chmodBinEntries(pkgDir);
+    }
+    // Write fingerprints only after ALL builds succeed (and only when enabled)
+    if (useFingerprint) {
+        for (const { fpPath, fpValue } of toRun) {
+            writeFingerprint(fpPath, fpValue);
+        }
+    }
+}
+function chmodBinEntries(pkgDir) {
+    const pkgJsonPath = join(pkgDir, 'package.json');
+    if (!existsSync(pkgJsonPath))
+        return;
+    const json = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+    const bin = json.bin;
+    if (bin == null)
+        return;
+    const paths = typeof bin === 'string'
+        ? [bin]
+        : typeof bin === 'object'
+            ? Object.values(bin)
+            : [];
+    for (const rel of paths) {
+        const abs = resolve(pkgDir, rel);
+        if (existsSync(abs)) {
+            chmodSync(abs, 0o755);
+        }
+    }
+}
+export async function runTests(opts) {
+    const spawn = opts.spawn ?? defaultSpawn;
+    const cwd = resolve(opts.cwd);
+    const useFingerprint = opts.force !== undefined;
+    const force = opts.force ?? false;
+    if (useFingerprint) {
+        const fpPath = fingerprintPath(cwd, 'test');
+        const fpValue = computeRootFingerprint(cwd, 'test');
+        if (!force) {
+            const stored = readFingerprint(fpPath);
+            if (stored === fpValue) {
+                console.log('⏭ test (unchanged)');
+                return; // skip
+            }
+        }
+        await runOrThrow(spawn, pnpmExec('vitest', 'run'), cwd);
+        writeFingerprint(fpPath, fpValue);
+    }
+    else {
+        await runOrThrow(spawn, pnpmExec('vitest', 'run'), cwd);
+    }
+}
+export async function check(opts) {
+    const spawn = opts.spawn ?? defaultSpawn;
+    const cwd = resolve(opts.cwd);
+    const useFingerprint = opts.force !== undefined;
+    const force = opts.force ?? false;
+    if (useFingerprint) {
+        const fpPath = fingerprintPath(cwd, 'check');
+        const fpValue = computeRootFingerprint(cwd, 'check');
+        if (!force) {
+            const stored = readFingerprint(fpPath);
+            if (stored === fpValue) {
+                console.log('⏭ check (unchanged)');
+                return; // skip
+            }
+        }
+        await runOrThrow(spawn, pnpmExec('biome', 'check', '.'), cwd);
+        await validateWorkflows(spawn, cwd);
+        writeFingerprint(fpPath, fpValue);
+    }
+    else {
+        await runOrThrow(spawn, pnpmExec('biome', 'check', '.'), cwd);
+        await validateWorkflows(spawn, cwd);
+    }
+}
+export async function format(opts) {
+    const spawn = opts.spawn ?? defaultSpawn;
+    const cwd = resolve(opts.cwd);
+    await runOrThrow(spawn, pnpmExec('biome', 'format', '--write', '.'), cwd);
+}
+/** Discover .workflows/*.yaml and validate each with `uwf workflow validate`. Skips if uwf is not installed. */
+async function validateWorkflows(spawn, cwd) {
+    const dirs = [join(cwd, '.workflows'), join(cwd, '.workflow')];
+    const files = [];
+    for (const dir of dirs) {
+        if (!existsSync(dir))
+            continue;
+        for (const entry of readdirSync(dir)) {
+            if (entry.endsWith('.yaml') || entry.endsWith('.yml')) {
+                files.push(join(dir, entry));
+            }
+        }
+    }
+    if (files.length === 0)
+        return;
+    // Check if uwf is available
+    const { code: uwfCheck } = await spawn(['which', 'uwf'], cwd);
+    if (uwfCheck !== 0) {
+        console.log('⚠ uwf not installed, skipping workflow validation');
+        return;
+    }
+    const errors = [];
+    for (const file of files) {
+        const { code, stderr } = await spawn(['uwf', 'workflow', 'validate', file], cwd);
+        if (code !== 0) {
+            errors.push(`${file}: ${stderr.trim() || 'validation failed'}`);
+        }
+    }
+    if (errors.length > 0) {
+        throw new Error(`Workflow validation failed:\n${errors.join('\n')}`);
+    }
+    console.log(`✓ ${files.length} workflow(s) validated`);
+}

package/dist/commands/index.d.ts

@@ -0,0 +1,7 @@
+export { type BumpOptions, bump } from './bump.js';
+export { type DeployCommandOptions, deploy } from './deploy.js';
+export { build, check, type DevCommandOptions, format, runTests } from './dev.js';
+export { type InitOptions, init } from './init.js';
+export { type LinkCommandOptions, link, linkStatus, unlink } from './link.js';
+export { type PublishOptions, publish } from './publish.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,iBAAiB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACjF,OAAO,EAAE,KAAK,WAAW,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,EAAE,KAAK,kBAAkB,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAC7E,OAAO,EAAE,KAAK,cAAc,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA"}

package/dist/commands/index.js

@@ -0,0 +1,7 @@
+// Export all command functions
+export { bump } from './bump.js';
+export { deploy } from './deploy.js';
+export { build, check, format, runTests } from './dev.js';
+export { init } from './init.js';
+export { link, linkStatus, unlink } from './link.js';
+export { publish } from './publish.js';

package/dist/commands/init.d.ts

@@ -0,0 +1,5 @@
+export type InitOptions = {
+    targetDir: string;
+};
+export declare function init(opts: InitOptions): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG;IACxB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AA6BD,wBAAsB,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C3D"}