prd-to-flutter 0.1.0

package/dist/commands/generate.js

@@ -0,0 +1,120 @@
+import { logger } from '../core/logger.js';
+import { FailFastError, reportFailure } from '../core/fail-fast.js';
+import { createRunContext, } from '../core/run-context.js';
+import { prdClone } from '../core/prd-clone.js';
+import { readFlutterProjectDocs } from '../core/project-doc-reader.js';
+import { readVueProjectDocs } from '../core/vue-project-reader.js';
+import { locateVuePage } from '../core/vue-page-locator.js';
+import { capturePrototypeRuntime } from '../core/playwright-capture.js';
+import { buildSemanticModel } from '../core/semantic-model-builder.js';
+import { buildFeatureCoverage, mergeFeatureCoverageIntoSemanticModel, } from '../core/feature-coverage-builder.js';
+import { writeScreenshotExplorationPlan } from '../core/screenshot-exploration-plan-writer.js';
+import { scanFlutterProject } from '../core/flutter-project-scanner.js';
+import { detectExistingFlutterPage } from '../core/existing-page-detector.js';
+import { writeImplementationPlan } from '../core/implementation-plan-writer.js';
+import { writeReport } from '../core/report-writer.js';
+import { writeTaskIndex } from '../core/task-index-writer.js';
+import { loadProjectProfile, ProfileConfigError } from '../core/profile.js';
+export async function generateCommand(options) {
+    const ctx = createRunContext(options);
+    logger.stage(`p2f generate · ${options.pageName}`);
+    logger.info(`prototypeUrl: ${options.prototypeUrl}`);
+    logger.info(`workspace   : ${ctx.paths.root}`);
+    logger.info(`taskDir     : ${ctx.taskDir}`);
+    logger.info(`runDir      : ${ctx.runDir}`);
+    try {
+        const { profile, configPath } = loadProjectProfile(ctx.paths.root);
+        logger.info(`profile     : ${profile.name}${configPath ? ` (${configPath})` : ' (builtin)'}`);
+        // --- Phase 2 stages implemented now --------------------------------
+        logger.stage('Stage: sync-prd-source');
+        const sync = await prdClone(ctx);
+        logger.stage('Stage: read-flutter-docs');
+        readFlutterProjectDocs(ctx, profile, configPath);
+        const snapshot = scanFlutterProject(ctx, profile, configPath);
+        logger.stage('Stage: read-vue-docs');
+        const vueDocs = readVueProjectDocs(ctx, sync.path, profile);
+        // --- Phase 3+ stages still stubbed ---------------------------------
+        logger.stage('Stage: locate-vue-page');
+        const page = locateVuePage(ctx, vueDocs, options.prototypeUrl, profile);
+        writeTaskIndex(ctx, {
+            located: page,
+            vueDocs,
+            stage: 'located',
+        });
+        logger.stage('Stage: build-feature-coverage');
+        const coverage = buildFeatureCoverage(ctx, page, vueDocs);
+        logger.stage('Stage: capture-runtime');
+        const capture = await capturePrototypeRuntime(ctx, options.prototypeUrl, page);
+        logger.stage('Stage: build-semantic-model');
+        const model = buildSemanticModel(ctx, page, capture);
+        logger.stage('Stage: merge-feature-coverage');
+        mergeFeatureCoverageIntoSemanticModel(ctx, model, coverage);
+        logger.stage('Stage: write-screenshot-exploration-plan');
+        const screenshotPlan = writeScreenshotExplorationPlan(ctx, model, coverage, capture);
+        logger.stage('Stage: detect-existing-page');
+        const verdict = detectExistingFlutterPage(ctx, snapshot, model);
+        writeTaskIndex(ctx, {
+            located: page,
+            vueDocs,
+            snapshot,
+            verdict,
+            model,
+            stage: 'planned',
+        });
+        logger.stage('Stage: write-implementation-plan');
+        const plan = writeImplementationPlan(ctx, model, verdict, snapshot);
+        const report = writeReport(ctx, {
+            status: 'ready',
+            flutter: {
+                pageExisted: verdict.pageExists,
+                pageStatus: verdict.status,
+                confidence: verdict.confidence,
+                reviewRequired: verdict.agentReview.required,
+                targetModule: verdict.targetModule,
+                targetPageFile: verdict.targetPageFile ?? undefined,
+            },
+            risks: plan.highRisk,
+            reviewHints: plan.unknowns,
+        });
+        writeTaskIndex(ctx, {
+            located: page,
+            vueDocs,
+            snapshot,
+            verdict,
+            model,
+            stage: 'planned',
+        });
+        logger.success(`数据采集完成 · 报告：${report.pageMarkdown}`);
+        logger.info(`下一步：让 agent 读取 ${ctx.taskDir}/main.md，先按 ${screenshotPlan.markdownPath} 自动探索补全截图，再实现页面。`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof ProfileConfigError) {
+            logger.error(err.message);
+            return 1;
+        }
+        if (err instanceof FailFastError) {
+            reportFailure(err);
+            try {
+                writeReport(ctx, {
+                    status: 'stopped',
+                    failure: {
+                        stage: err.detail.stage,
+                        action: err.detail.action,
+                        reason: err.detail.reason,
+                        completedSteps: err.detail.completedSteps,
+                        pendingSteps: err.detail.pendingSteps,
+                        suggestions: err.detail.suggestions,
+                    },
+                });
+            }
+            catch (reportErr) {
+                logger.warn(`报告写入失败（忽略）：${reportErr.message}`);
+            }
+            return 1;
+        }
+        logger.error(`意外错误：${err.stack ?? String(err)}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=generate.js.map

package/dist/commands/generate.js.map

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

package/dist/commands/init.js

@@ -0,0 +1,46 @@
+import { mkdirSync } from 'node:fs';
+import { logger } from '../core/logger.js';
+import { FailFastError, reportFailure } from '../core/fail-fast.js';
+import { createRunContext, markComplete } from '../core/run-context.js';
+import { skillInstall } from '../core/skill-install.js';
+import { prdClone } from '../core/prd-clone.js';
+import { prdInstall } from '../core/prd-install.js';
+import { playwrightInstall } from '../core/playwright-install.js';
+export async function initCommand(opts) {
+    // init does not have a target page; we reuse RunContext with a synthetic one.
+    const runOpts = {
+        pageName: '__bootstrap__',
+        prototypeUrl: '(bootstrap)',
+        workspace: opts.workspace,
+        kind: 'system',
+        stagePlan: ['sync-prd-source', 'prd-install', 'playwright-install', 'skill-install'],
+    };
+    const ctx = createRunContext(runOpts);
+    mkdirSync(ctx.paths.workspaceDir, { recursive: true });
+    mkdirSync(ctx.paths.pagesDir, { recursive: true });
+    mkdirSync(ctx.paths.projectDir, { recursive: true });
+    mkdirSync(ctx.paths.logsDir, { recursive: true });
+    try {
+        logger.stage('Stage: sync-prd-source');
+        const clone = await prdClone(ctx);
+        logger.stage('Stage: prd-install');
+        const deps = await prdInstall(ctx, clone.path);
+        logger.stage('Stage: playwright-install');
+        await playwrightInstall(ctx);
+        logger.stage(`Stage: skill-install · target ${ctx.paths.root}`);
+        const skill = skillInstall({ workspace: ctx.paths.root });
+        markComplete(ctx, 'skill-install');
+        logger.success(`init OK. prototype commit=${clone.commit.slice(0, 7)} source=${clone.source} ` +
+            `deps=${deps.packageManager}${deps.ran ? '(installed)' : '(cached)'} ` +
+            `chromium=ready skill=${skill.installed.length}/2`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof FailFastError) {
+            reportFailure(err);
+            return 1;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAwB,MAAM,wBAAwB,CAAC;AAC9F,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAMlE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAiB;IACjD,8EAA8E;IAC9E,MAAM,OAAO,GAAoB;QAC/B,QAAQ,EAAE,eAAe;QACzB,YAAY,EAAE,aAAa;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,CAAC,iBAAiB,EAAE,aAAa,EAAE,oBAAoB,EAAE,eAAe,CAAC;KACrF,CAAC;IACF,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACtC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;QAElC,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAE/C,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC1C,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAE7B,MAAM,CAAC,KAAK,CAAC,iCAAiC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QAC1D,YAAY,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAEnC,MAAM,CAAC,OAAO,CACZ,6BAA6B,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,KAAK,CAAC,MAAM,GAAG;YAC7E,QAAQ,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,GAAG;YACtE,wBAAwB,KAAK,CAAC,SAAS,CAAC,MAAM,IAAI,CACrD,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,aAAa,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/commands/paths.js

@@ -0,0 +1,58 @@
+import { join } from 'node:path';
+import { logger } from '../core/logger.js';
+import { buildWorkspacePaths } from '../core/paths.js';
+import { deriveTaskName } from '../core/route-name.js';
+export async function pathsCommand(opts) {
+    if (!opts.json)
+        logger.stage('Stage: resolve-paths');
+    const paths = buildWorkspacePaths(opts.workspace);
+    const taskName = opts.pageName || opts.prototypeUrl
+        ? deriveTaskName({ pageName: opts.pageName, prototypeUrl: opts.prototypeUrl })
+        : undefined;
+    const payload = {
+        workspaceRoot: paths.root,
+        p2fWorkspace: paths.workspaceDir,
+        prdSource: paths.prdSourceDir,
+        pages: paths.pagesDir,
+        project: paths.projectDir,
+        flutterProjectJson: join(paths.projectDir, 'flutter-project.json'),
+        logs: paths.logsDir,
+        ...(taskName
+            ? {
+                taskName,
+                taskDir: join(paths.pagesDir, taskName),
+                cliDir: join(paths.pagesDir, taskName, 'cli'),
+                agentDir: join(paths.pagesDir, taskName, 'agent'),
+                cliRuntimeDir: join(paths.pagesDir, taskName, 'cli', 'runtime'),
+                agentRuntimeDir: join(paths.pagesDir, taskName, 'agent', 'runtime'),
+                screenshotsDir: join(paths.pagesDir, taskName, 'agent', 'screenshots'),
+                agentManifest: join(paths.pagesDir, taskName, 'agent', 'manifest.json'),
+                mainMd: join(paths.pagesDir, taskName, 'main.md'),
+            }
+            : {}),
+    };
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(payload, null, 2) + '\n');
+        return 0;
+    }
+    logger.info(`workspaceRoot : ${payload.workspaceRoot}`);
+    logger.info(`p2fWorkspace  : ${payload.p2fWorkspace}`);
+    logger.info(`prdSource     : ${payload.prdSource}`);
+    logger.info(`pages         : ${payload.pages}`);
+    logger.info(`project       : ${payload.project}`);
+    logger.info(`flutterProject: ${payload.flutterProjectJson}`);
+    logger.info(`logs          : ${payload.logs}`);
+    if (taskName) {
+        logger.info(`taskName      : ${payload.taskName}`);
+        logger.info(`taskDir       : ${payload.taskDir}`);
+        logger.info(`cliDir        : ${payload.cliDir}`);
+        logger.info(`agentDir      : ${payload.agentDir}`);
+        logger.info(`cliRuntimeDir : ${payload.cliRuntimeDir}`);
+        logger.info(`agentRuntime  : ${payload.agentRuntimeDir}`);
+        logger.info(`screenshotsDir: ${payload.screenshotsDir}`);
+        logger.info(`agentManifest : ${payload.agentManifest}`);
+        logger.info(`mainMd        : ${payload.mainMd}`);
+    }
+    return 0;
+}
+//# sourceMappingURL=paths.js.map

package/dist/commands/paths.js.map

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

package/dist/commands/remove.js

@@ -0,0 +1,23 @@
+import { existsSync, rmSync } from 'node:fs';
+import { logger } from '../core/logger.js';
+import { buildWorkspacePaths } from '../core/paths.js';
+import { listSkillTargets } from '../core/skill-install.js';
+export async function removeCommand(opts) {
+    logger.stage('Stage: remove');
+    const paths = buildWorkspacePaths(opts.workspace);
+    const targets = [paths.workspaceDir, ...listSkillTargets(paths.root)];
+    let removed = 0;
+    logger.info(`workspace: ${paths.root}`);
+    for (const target of targets) {
+        if (!existsSync(target)) {
+            logger.info(`already removed: ${target}`);
+            continue;
+        }
+        rmSync(target, { recursive: true, force: true });
+        logger.success(`removed: ${target}`);
+        removed += 1;
+    }
+    logger.success(`remove OK · removed=${removed}/${targets.length}`);
+    return 0;
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAM5D,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAmB;IACrD,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,MAAM,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,YAAY,MAAM,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC,CAAC;IACf,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,uBAAuB,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/screenshots-audit.js

@@ -0,0 +1,39 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../core/logger.js';
+import { auditAgentScreenshots } from '../core/screenshot-auditor.js';
+import { buildWorkspacePaths } from '../core/paths.js';
+import { deriveTaskName } from '../core/route-name.js';
+export async function screenshotsAuditCommand(opts) {
+    if (!opts.json)
+        logger.stage('Stage: screenshots-audit');
+    if (!opts.pageName && !opts.prototypeUrl) {
+        logger.error('必须提供 --url "<页面链接>" 或 --page "<页面名>" 来定位任务目录。');
+        return 2;
+    }
+    const paths = buildWorkspacePaths(opts.workspace);
+    const taskName = deriveTaskName({ pageName: opts.pageName, prototypeUrl: opts.prototypeUrl });
+    const pageDir = join(paths.pagesDir, taskName);
+    if (!existsSync(pageDir)) {
+        logger.error(`任务目录不存在：${pageDir}`);
+        return 2;
+    }
+    const audit = auditAgentScreenshots({
+        pageDir,
+        pageKey: taskName,
+        pageName: opts.pageName || taskName,
+    });
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(audit, null, 2) + '\n');
+        return audit.summary.suspectedPlatformShell > 0 ? 1 : 0;
+    }
+    logger.success(`agent screenshot audit → ${audit.markdownPath}`);
+    logger.info(`screenshots=${audit.summary.total} exactGroups=${audit.summary.exactDuplicateGroups} ` +
+        `nearGroups=${audit.summary.nearDuplicateGroups} platformShell=${audit.summary.suspectedPlatformShell}`);
+    if (audit.summary.suspectedPlatformShell > 0) {
+        logger.error('发现疑似原型平台壳层截图，请删除并按 `.phone-screen` 元素重新截图。');
+        return 1;
+    }
+    return 0;
+}
+//# sourceMappingURL=screenshots-audit.js.map

package/dist/commands/screenshots-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshots-audit.js","sourceRoot":"","sources":["../../src/commands/screenshots-audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AASvD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAA6B;IACzE,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC9F,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,EAAE,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,qBAAqB,CAAC;QAClC,OAAO;QACP,OAAO,EAAE,QAAQ;QACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ;KACpC,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5D,OAAO,KAAK,CAAC,OAAO,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,4BAA4B,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,IAAI,CACT,eAAe,KAAK,CAAC,OAAO,CAAC,KAAK,gBAAgB,KAAK,CAAC,OAAO,CAAC,oBAAoB,GAAG;QACrF,cAAc,KAAK,CAAC,OAAO,CAAC,mBAAmB,kBAAkB,KAAK,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAC1G,CAAC;IACF,IAAI,KAAK,CAAC,OAAO,CAAC,sBAAsB,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/skills-install.js

@@ -0,0 +1,21 @@
+import { resolve } from 'node:path';
+import { logger } from '../core/logger.js';
+import { FailFastError, reportFailure } from '../core/fail-fast.js';
+import { skillInstall } from '../core/skill-install.js';
+export async function skillsInstallCommand(opts) {
+    const workspace = opts.workspace ? resolve(opts.workspace) : process.cwd();
+    logger.stage(`Stage: skill-install · target ${workspace}`);
+    try {
+        const res = skillInstall({ workspace });
+        logger.success(`内置 p2f skill 已安装/更新：${res.installed.length} 个目标目录。`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof FailFastError) {
+            reportFailure(err);
+            return 1;
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=skills-install.js.map

package/dist/commands/skills-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills-install.js","sourceRoot":"","sources":["../../src/commands/skills-install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAMxD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAA0B;IACnE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3E,MAAM,CAAC,KAAK,CAAC,iCAAiC,SAAS,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,OAAO,CACZ,uBAAuB,GAAG,CAAC,SAAS,CAAC,MAAM,SAAS,CACrD,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACjC,aAAa,CAAC,GAAG,CAAC,CAAC;YACnB,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/commands/sync.js

@@ -0,0 +1,84 @@
+import { existsSync } from 'node:fs';
+import { logger } from '../core/logger.js';
+import { FailFastError, failFast, reportFailure } from '../core/fail-fast.js';
+import { createRunContext, markComplete } from '../core/run-context.js';
+import { checkPrdFreshness, prdClone } from '../core/prd-clone.js';
+import { PROTOTYPE_BRANCH } from '../core/paths.js';
+/**
+ * Check whether the local PRD prototype clone matches origin/<branch>; if not,
+ * pull the latest revision and force-reset the working tree (delegates to the
+ * existing `prdClone` update path).
+ *
+ * Designed to be safe to run repeatedly: idempotent when already up-to-date.
+ */
+export async function syncCommand(opts) {
+    const runOpts = {
+        pageName: '__sync__',
+        prototypeUrl: '(sync)',
+        workspace: opts.workspace,
+        kind: 'system',
+        stagePlan: ['prd-sync-check', 'prd-sync-update'],
+    };
+    const ctx = createRunContext(runOpts);
+    try {
+        if (!existsSync(ctx.paths.prdSourceDir)) {
+            failFast({
+                stage: 'prd-sync-check',
+                action: `stat ${ctx.paths.prdSourceDir}`,
+                reason: 'PRD 仓库尚未初始化，无法检查或拉取最新代码。',
+                completedSteps: [...ctx.completedSteps],
+                pendingSteps: [...ctx.pendingSteps],
+                suggestions: [
+                    '先执行 `p2f init` 完成首次克隆。',
+                ],
+            });
+        }
+        logger.stage('Stage: prd-sync-check');
+        const fresh = await runFreshnessCheck(ctx.paths.prdSourceDir);
+        if (fresh.upToDate) {
+            logger.success(`最新 · ${fresh.localCommit.slice(0, 7)} (origin/${PROTOTYPE_BRANCH})`);
+            markComplete(ctx, 'prd-sync-check');
+            markComplete(ctx, 'prd-sync-update');
+            return 0;
+        }
+        logger.warn(`PRD 本地副本不是最新：local ${fresh.localCommit.slice(0, 7)} != ` +
+            `origin/${PROTOTYPE_BRANCH} ${fresh.remoteCommit.slice(0, 7)} ` +
+            `(behind ${fresh.behind}, ahead ${fresh.ahead})`);
+        markComplete(ctx, 'prd-sync-check');
+        logger.stage('Stage: prd-sync-update');
+        const result = await prdClone(ctx);
+        markComplete(ctx, 'prd-sync-update');
+        logger.success(`PRD 本地副本已更新到 origin/${result.branch} · ${result.commit.slice(0, 7)}`);
+        return 0;
+    }
+    catch (err) {
+        if (err instanceof FailFastError) {
+            reportFailure(err);
+            return 1;
+        }
+        throw err;
+    }
+}
+async function runFreshnessCheck(prototypeDir) {
+    if (!process.env.GIT_SSH_COMMAND) {
+        process.env.GIT_SSH_COMMAND = 'ssh -o ConnectTimeout=5 -o BatchMode=yes';
+    }
+    try {
+        return await checkPrdFreshness(prototypeDir);
+    }
+    catch (err) {
+        const msg = err.shortMessage ?? err.message;
+        failFast({
+            stage: 'prd-sync-check',
+            action: `git fetch origin ${PROTOTYPE_BRANCH} && git rev-parse`,
+            reason: `检查 PRD 仓库新鲜度失败：${msg}`,
+            suggestions: [
+                '检查网络是否可以访问 code.nexita.net。',
+                '确认当前账号有 TradeAppPrd 仓库 SSH 权限。',
+                '如有 GIT_SSH_COMMAND 自定义，确认其参数有效。',
+            ],
+            needsUserDecision: ['请解决网络或仓库权限后重试。'],
+        });
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/sync.js.map

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

package/dist/commands/update.js

@@ -0,0 +1,93 @@
+import { execa } from 'execa';
+import { logger } from '../core/logger.js';
+import { checkForUpdates } from '../core/update-checker.js';
+export async function updateCommand(opts) {
+    const json = Boolean(opts.json);
+    let result;
+    try {
+        if (!json)
+            logger.stage('Stage: update-check');
+        result = await checkForUpdates({ repo: opts.repo });
+    }
+    catch (err) {
+        const message = errorMessage(err);
+        if (json) {
+            printJson({ ok: false, error: message });
+        }
+        else {
+            logger.error(`检查更新失败：${message}`);
+        }
+        return 1;
+    }
+    const shouldInstall = !opts.check && (result.updateAvailable || opts.force);
+    if (opts.check) {
+        if (json) {
+            printJson({ ok: true, installed: false, ...result });
+        }
+        else {
+            printCheckResult(result);
+        }
+        return 0;
+    }
+    if (!shouldInstall) {
+        if (json) {
+            printJson({ ok: true, installed: false, ...result });
+        }
+        else {
+            logger.success(`已是最新版本 · v${result.currentVersion}`);
+        }
+        return 0;
+    }
+    try {
+        if (!json) {
+            logger.stage(`Stage: update-install · ${result.latestTag}`);
+        }
+        await installLatest(result.installSpec, json);
+        if (json) {
+            printJson({ ok: true, installed: true, ...result });
+        }
+        else {
+            logger.success(`已更新到 ${result.latestTag}`);
+        }
+        return 0;
+    }
+    catch (err) {
+        const message = errorMessage(err);
+        if (json) {
+            printJson({ ok: false, installed: false, error: message, ...result });
+        }
+        else {
+            logger.error(`安装更新失败：${message}`);
+        }
+        return 1;
+    }
+}
+function printCheckResult(result) {
+    if (result.updateAvailable) {
+        logger.warn(`发现新版本 · 当前 v${result.currentVersion}，最新 ${result.latestTag}`);
+        return;
+    }
+    logger.success(`已是最新版本 · v${result.currentVersion}`);
+}
+async function installLatest(installSpec, quiet) {
+    const args = ['install', '-g', installSpec];
+    const env = {
+        ...process.env,
+        GIT_SSH_COMMAND: process.env.GIT_SSH_COMMAND ?? 'ssh -o ConnectTimeout=5 -o BatchMode=yes',
+    };
+    if (quiet) {
+        await execa('npm', args, { stdout: 'pipe', stderr: 'pipe', env });
+        return;
+    }
+    await execa('npm', args, { stdio: 'inherit', env });
+}
+function printJson(value) {
+    console.log(JSON.stringify(value, null, 2));
+}
+function errorMessage(err) {
+    const execaError = err;
+    const message = execaError.shortMessage ?? err.message;
+    const stderr = typeof execaError.stderr === 'string' ? execaError.stderr.trim() : '';
+    return stderr ? `${message}\n${stderr}` : message;
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAmB,MAAM,OAAO,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAA0B,MAAM,2BAA2B,CAAC;AASpF,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAmB;IACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,MAAyB,CAAC;IAE9B,IAAI,CAAC;QACH,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC/C,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5E,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,aAAa,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,2BAA2B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,OAAO,CAAC,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,IAAI,EAAE,CAAC;YACT,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAyB;IACjD,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,cAAc,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3E,OAAO;IACT,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,aAAa,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,KAAc;IAC9D,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG;QACV,GAAG,OAAO,CAAC,GAAG;QACd,eAAe,EACb,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,0CAA0C;KAC5E,CAAC;IAEF,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAClE,OAAO;IACT,CAAC;IACD,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,YAAY,CAAC,GAAY;IAChC,MAAM,UAAU,GAAG,GAAiB,CAAC;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,IAAK,GAAa,CAAC,OAAO,CAAC;IAClE,MAAM,MAAM,GAAG,OAAO,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACrF,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;AACpD,CAAC"}