extract-annotation-source

注釈ソースの抽出

実行時スナップショットから Axhub のプロトタイプコンテキストを読み取ります。ページは読み取り専用として扱ってください。

ワークフロー

1. Playwright、Browser、Chrome、またはページの JavaScript を評価できる同等のツールを使って、指定されたプロトタイプ URL を開きます。
2. アプリがレンダリングされるまで待ってから、window.__AXHUB_ANNOTATION_SOURCE__ が存在するかを短時間ポーリングします。
3. その値を評価して返します。オブジェクトを変更したり、window に書き戻したりしないでください。
4. 値が見つからない場合は、URL、ページタイトル、関連するコンソールエラー、および注釈の実行時スナップショットが公開されていないことを報告します。
5. ユーザーが Axhub Make へのレビューレポートの送信を求めた場合は、references/review-report-submission.md を読みます。

最小限のページ評価：

await page.waitForFunction(() => window.__AXHUB_ANNOTATION_SOURCE__, { timeout: 10000 });
const source = await page.evaluate(() => window.__AXHUB_ANNOTATION_SOURCE__);

報告する内容

• source.directory のディレクトリー／PRD の概要。
• type: "markdown" のディレクトリーノードに含まれる Markdown または PRD のエントリー。
• 注釈の数と、重要なノードフィールド：id、title、pageId、locator、annotationText、aiPrompt、color、controls。
• 存在する場合は、source.source からソースの引き継ぎ情報を報告します。root と manifest を報告してください。ソースが必要な場合は、manifest と関連ファイルを root 経由で読み取ります。
• images.length を確認して、画像が添付されているかを示します。ユーザーからの依頼がない限り、画像をダウンロードしないでください。

データ構造

type AnnotationSourceRuntimeSnapshot = {
  directory: AnnotationDirectory | null;
  nodes: AnnotationNode[];
  source?: {
    root?: string;
    manifest?: string;
  };
};

• directory.nodes はプロトタイプのツリーです。ノードタイプは folder、route、link、markdown です。
• nodes は、現在のページ、選択状態、カラーのフィルターに関係なく、すべての注釈を含みます。
• 各注釈ノードには、id、index、任意の title、任意の pageId、locator、aiPrompt、annotationText、hasMarkdown、color、images、任意の controls、createdAt、updatedAt が含まれます。
• source はソースコードを特定するための参照情報にすぎません。ソースを含めて公開された HTML では、manifest は source/manifest.json を指します。そのパスは source.root を基準に解決してください。