prd-to-flutter 0.1.0

package/dist/core/project-doc-reader.js.map

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

package/dist/core/report-writer.js

@@ -0,0 +1,90 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { markComplete } from './run-context.js';
+import { logger } from './logger.js';
+export function writeReport(ctx, inputs) {
+    const pageOutDir = join(ctx.pageDir, 'output');
+    mkdirSync(pageOutDir, { recursive: true });
+    const pageMarkdown = join(pageOutDir, 'generate-report.md');
+    const runMarkdown = join(ctx.runDir, 'report.md');
+    const reportJsonPath = join(pageOutDir, 'generate-report.json');
+    const now = new Date().toISOString();
+    const payload = {
+        pageKey: ctx.pageKey,
+        pageName: ctx.options.pageName,
+        prototypeUrl: ctx.options.prototypeUrl,
+        prototypeCommit: ctx.prototypeCommit ?? '',
+        prototypeSource: ctx.prototypeSource ?? 'remote',
+        createdAt: now,
+        status: inputs.status,
+        failure: inputs.failure ?? null,
+        flutter: inputs.flutter ?? null,
+        assets: inputs.assets ?? null,
+        screenshots: inputs.screenshots ?? [],
+        states: inputs.states ?? [],
+        interactions: inputs.interactions ?? [],
+        risks: inputs.risks ?? [],
+        reviewHints: inputs.reviewHints ?? [],
+    };
+    writeFileSync(reportJsonPath, JSON.stringify(payload, null, 2), 'utf8');
+    const md = renderMarkdown(ctx, inputs, now);
+    writeFileSync(pageMarkdown, md, 'utf8');
+    writeFileSync(runMarkdown, md, 'utf8');
+    markComplete(ctx, 'write-report');
+    logger.success(`Report → ${pageMarkdown}`);
+    return { status: inputs.status, pageMarkdown, runMarkdown, reportJsonPath };
+}
+function renderMarkdown(ctx, inputs, now) {
+    const lines = [
+        `# p2f 生成报告 - ${ctx.options.pageName}`,
+        '',
+        `- 页面目录名：\`${ctx.pageKey}\``,
+        `- 原型链接：${ctx.options.prototypeUrl}`,
+        `- 原型提交：${ctx.prototypeCommit ?? '（未知）'}`,
+        `- 原型来源：${ctx.prototypeSource ?? '（未知）'}`,
+        `- 创建时间: ${now}`,
+        `- 状态: **${inputs.status}**`,
+        '',
+    ];
+    if (inputs.failure) {
+        lines.push('## 失败信息', '', `- 阶段: \`${inputs.failure.stage}\``, `- 动作: \`${inputs.failure.action ?? ''}\``, `- 原因: ${inputs.failure.reason}`);
+        if (inputs.failure.completedSteps?.length) {
+            lines.push('', '### 已完成');
+            for (const s of inputs.failure.completedSteps)
+                lines.push(`- ${s}`);
+        }
+        if (inputs.failure.pendingSteps?.length) {
+            lines.push('', '### 未完成');
+            for (const s of inputs.failure.pendingSteps)
+                lines.push(`- ${s}`);
+        }
+        if (inputs.failure.suggestions?.length) {
+            lines.push('', '### 建议方案');
+            inputs.failure.suggestions.forEach((s, i) => lines.push(`${i + 1}. ${s}`));
+        }
+        lines.push('');
+    }
+    if (inputs.flutter) {
+        lines.push('## agent 实现线索', '', `- 页面存在性状态：${inputs.flutter.pageStatus ?? (inputs.flutter.pageExisted ? 'exists' : 'missing')}`, `- 页面是否已确认存在：${inputs.flutter.pageExisted}`, `- 置信度：${inputs.flutter.confidence ?? '（未知）'}`, `- 是否需要 agent 复核：${inputs.flutter.reviewRequired ?? false}`, `- 目标模块：${inputs.flutter.targetModule ?? '（无）'}`, `- 目标页面文件：${inputs.flutter.targetPageFile ?? '（无）'}`, '', '> p2f CLI 不直接修改 Dart 文件；请由 agent 根据本目录数据和 YouFi 项目规范实现。', '');
+    }
+    if (inputs.assets) {
+        lines.push('## 资源', '', `- 已复用: ${(inputs.assets.reused ?? []).length}`, `- 已复制: ${(inputs.assets.copied ?? []).length}`, `- pubspecNeedsUpdate: ${inputs.assets.pubspecNeedsUpdate ?? false}`, '');
+    }
+    if (inputs.screenshots?.length) {
+        lines.push('## 截图', '', ...inputs.screenshots.map((s) => `- ${s}`), '');
+    }
+    if (inputs.states?.length) {
+        lines.push('## 页面状态', '', ...inputs.states.map((s) => `- ${s}`), '');
+    }
+    if (inputs.interactions?.length) {
+        lines.push('## 交互', '', ...inputs.interactions.map((s) => `- ${s}`), '');
+    }
+    if (inputs.risks?.length) {
+        lines.push('## 风险点', '', ...inputs.risks.map((s) => `- ${s}`), '');
+    }
+    if (inputs.reviewHints?.length) {
+        lines.push('## 审核建议', '', ...inputs.reviewHints.map((s) => `- ${s}`), '');
+    }
+    return lines.join('\n') + '\n';
+}
+//# sourceMappingURL=report-writer.js.map

package/dist/core/report-writer.js.map

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

package/dist/core/route-name.js

@@ -0,0 +1,60 @@
+export function deriveTaskName(input) {
+    const route = input.prototypeUrl ? routeNameFromUrl(input.prototypeUrl) : null;
+    if (route)
+        return route;
+    if (input.pageName)
+        return slugifyName(input.pageName);
+    return 'task';
+}
+export function routeNameFromUrl(raw) {
+    const pathname = extractPathname(raw);
+    if (!pathname)
+        return null;
+    const cleaned = pathname
+        .replace(/^\/+(prototype|design|spec)\//i, '')
+        .replace(/^\/+/, '')
+        .replace(/\/+$/, '');
+    if (!cleaned)
+        return null;
+    const parts = cleaned.split('/').filter(Boolean);
+    const last = parts[parts.length - 1];
+    return last ? slugifyName(last) : null;
+}
+export function slugifyName(raw) {
+    const slug = raw
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    if (slug)
+        return slug;
+    const hash = simpleHash(raw).toString(36);
+    return `task-${hash}`;
+}
+function extractPathname(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    if (trimmed.startsWith('#/'))
+        return trimmed.slice(1);
+    if (trimmed.startsWith('/'))
+        return trimmed;
+    try {
+        const u = new URL(trimmed);
+        if (u.hash.startsWith('#/'))
+            return u.hash.slice(1);
+        return u.pathname || '/';
+    }
+    catch {
+        return null;
+    }
+}
+function simpleHash(input) {
+    let h = 0;
+    for (let i = 0; i < input.length; i += 1) {
+        h = Math.imul(31, h) + input.charCodeAt(i);
+        h |= 0;
+    }
+    return Math.abs(h);
+}
+//# sourceMappingURL=route-name.js.map

package/dist/core/route-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-name.js","sourceRoot":"","sources":["../../src/core/route-name.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAG9B;IACC,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/E,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,OAAO,GAAG,QAAQ;SACrB,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC;SAC7C,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACvB,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,IAAI,GAAG,GAAG;SACb,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,OAAO,QAAQ,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAC3B,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpD,OAAO,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACrB,CAAC"}

package/dist/core/run-context.js

@@ -0,0 +1,160 @@
+import { join } from 'node:path';
+import { existsSync, mkdirSync, renameSync, writeFileSync } from 'node:fs';
+import { buildWorkspacePaths } from './paths.js';
+import { deriveTaskName } from './route-name.js';
+export function createRunContext(options) {
+    const paths = buildWorkspacePaths(options.workspace);
+    const pageKey = deriveTaskName({
+        pageName: options.pageName,
+        prototypeUrl: options.prototypeUrl,
+    });
+    const timestamp = formatTimestamp(new Date());
+    const isSystem = options.kind === 'system';
+    const taskDir = isSystem
+        ? join(paths.logsDir, pageKey, timestamp)
+        : join(paths.pagesDir, pageKey);
+    const cliDir = join(taskDir, 'cli');
+    const agentDir = join(taskDir, 'agent');
+    const agentScreenshotsDir = join(agentDir, 'screenshots');
+    const agentRuntimeDir = join(agentDir, 'runtime');
+    const agentManifestPath = join(agentDir, 'manifest.json');
+    const runDir = isSystem ? join(taskDir, 'runs', timestamp) : join(cliDir, 'runs', timestamp);
+    mkdirSync(taskDir, { recursive: true });
+    mkdirSync(cliDir, { recursive: true });
+    mkdirSync(agentScreenshotsDir, { recursive: true });
+    mkdirSync(agentRuntimeDir, { recursive: true });
+    mkdirSync(runDir, { recursive: true });
+    if (!isSystem && !existsSync(agentManifestPath)) {
+        writeFileSync(agentManifestPath, JSON.stringify({
+            pageKey,
+            pageName: options.pageName,
+            maintainedBy: 'agent',
+            updatedAt: null,
+            _note: 'Agent must update this ledger whenever it creates screenshots, runtime logs, notes, or modifies Flutter app files for this page.',
+            _schema: {
+                screenshots: [{ path: 'agent/screenshots/01-initial.png', state: 'initial', notes: '' }],
+                runtimeLogs: [{ path: 'agent/runtime/agent-screenshot-exploration.json', purpose: 'live-page exploration log' }],
+                notesFiles: [{ path: 'agent/notes.md', purpose: '' }],
+                modifiedAppFiles: [{ path: 'lib/.../*.dart', change: 'created|modified', notes: '' }],
+                otherOutputs: [{ path: '', purpose: '' }],
+            },
+            screenshots: [],
+            runtimeLogs: [],
+            notesFiles: [],
+            modifiedAppFiles: [],
+            otherOutputs: [],
+        }, null, 2) + '\n', 'utf8');
+    }
+    // Seed an initial log file so users can tail it during long runs.
+    writeFileSync(join(runDir, 'log.md'), [
+        `# p2f 运行日志：${options.pageName}`,
+        '',
+        `- prototypeUrl: ${options.prototypeUrl}`,
+        `- workspaceRoot: ${paths.root}`,
+        `- startedAt: ${new Date().toISOString()}`,
+        '',
+    ].join('\n'), 'utf8');
+    return {
+        options,
+        paths,
+        pageKey,
+        timestamp,
+        taskDir,
+        cliDir,
+        agentDir,
+        agentScreenshotsDir,
+        agentRuntimeDir,
+        agentManifestPath,
+        pageDir: cliDir,
+        runDir,
+        completedSteps: [],
+        pendingSteps: options.stagePlan ? [...options.stagePlan] : defaultStagePlan(),
+    };
+}
+export function markComplete(ctx, step) {
+    ctx.completedSteps.push(step);
+    const idx = ctx.pendingSteps.indexOf(step);
+    if (idx >= 0)
+        ctx.pendingSteps.splice(idx, 1);
+}
+/**
+ * Move the current run's artefact directories to a new pageKey. Safe to call
+ * multiple times; if the desired key is already in use by an unrelated run we
+ * append a numeric suffix so we never clobber.
+ */
+export function renamePageKey(ctx, candidate) {
+    const normalized = normalizeKey(candidate);
+    if (!normalized || normalized === ctx.pageKey)
+        return;
+    let finalKey = normalized;
+    let suffix = 1;
+    while (existsSync(join(ctx.paths.pagesDir, finalKey)) && finalKey !== ctx.pageKey) {
+        suffix += 1;
+        finalKey = `${normalized}-${suffix}`;
+    }
+    const oldTaskDir = ctx.taskDir;
+    const newTaskDir = join(ctx.paths.pagesDir, finalKey);
+    const newCliDir = join(newTaskDir, 'cli');
+    const newAgentDir = join(newTaskDir, 'agent');
+    const newAgentScreenshotsDir = join(newAgentDir, 'screenshots');
+    const newAgentRuntimeDir = join(newAgentDir, 'runtime');
+    const newAgentManifestPath = join(newAgentDir, 'manifest.json');
+    const newRunDir = join(newCliDir, 'runs', ctx.timestamp);
+    try {
+        if (existsSync(oldTaskDir))
+            renameSync(oldTaskDir, newTaskDir);
+    }
+    catch {
+        // Best-effort rename. On failure we leave the original dir in place and
+        // keep the old pageKey (downstream will still write under oldTaskDir).
+        return;
+    }
+    ctx.pageKey = finalKey;
+    ctx.taskDir = newTaskDir;
+    ctx.cliDir = newCliDir;
+    ctx.agentDir = newAgentDir;
+    ctx.agentScreenshotsDir = newAgentScreenshotsDir;
+    ctx.agentRuntimeDir = newAgentRuntimeDir;
+    ctx.agentManifestPath = newAgentManifestPath;
+    ctx.pageDir = newCliDir;
+    ctx.runDir = newRunDir;
+}
+function normalizeKey(raw) {
+    if (!raw)
+        return null;
+    const cleaned = raw
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return cleaned || null;
+}
+export function failureScaffold(ctx, partial) {
+    return {
+        completedSteps: partial.completedSteps ?? [...ctx.completedSteps],
+        pendingSteps: partial.pendingSteps ?? [...ctx.pendingSteps],
+        ...partial,
+    };
+}
+function formatTimestamp(d) {
+    const pad = (n) => n.toString().padStart(2, '0');
+    return (`${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}` +
+        `-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`);
+}
+function defaultStagePlan() {
+    return [
+        'sync-prd-source',
+        'read-flutter-docs',
+        'read-vue-docs',
+        'locate-vue-page',
+        'build-feature-coverage',
+        'capture-runtime',
+        'build-semantic-model',
+        'merge-feature-coverage',
+        'write-screenshot-exploration-plan',
+        'detect-existing-page',
+        'write-implementation-plan',
+        'write-report',
+    ];
+}
+//# sourceMappingURL=run-context.js.map

package/dist/core/run-context.js.map

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