analysis-20240314-123045/
├── repo/                    # Cloned repository code
├── reports/                 # Analysis report directory
│   ├── 01-Topic1.md
│   ├── 02-Topic2.md
│   ├── 03-Topic3.md
│   └── 04-OtherUserRequestedTopics.md
└── notion-sync.log         # Notion synchronization log (if notion sync script is enabled)

undefined

**Command Explanation**:

| Command | Description | Example |
|------|------|------|
| `list` | List all available parent pages | `python3 notion_sync.py list` |
| `list <query>` | Search for specific pages | `python3 notion_sync.py list "Reports"` |
| `info <page_id>` | Get page details | `python3 notion_sync.py info abc123...` |
| `upload <path> <page_id>` | Upload Markdown file or directory | `python3 notion_sync.py upload report.md abc123...` |

**Examples**:

```bash

**Parameter Explanation**:
- `path`: Markdown file path or directory path (required)
- `parent_page_id`: Notion parent page ID (required)
- `title`: Custom title (optional)
  - Single file: Used as page title
  - Directory: Used as directory parent page title, defaults to directory name

**Notion Page Structure (Directory Upload)**:

When uploading a directory, the script will create a hierarchical structure:

**Supported Markdown Formats**:
- Headings: `#`, `##`, `###`, `####`
- Code blocks: ```language ... ``` (auto-detects language)
- Unordered lists: `- ` or `* `
- Ordered lists: `1.`, `2.`
- Blockquotes: `> `
- Horizontal rules: `---` or `***`
- Regular paragraphs

**Chunked Upload Mechanism**:
Notion API limits a maximum of 100 blocks per request. For large files, the script will automatically:
1. Create an empty page
2. Append blocks in batches (up to 100 blocks each time)
3. Supports Markdown files of unlimited size

**API Configuration**:
- API Version: `2022-06-28`
- Authentication Method: Bearer Token
- Configuration File: `~/.config/notion/api_key`

**Error Handling**:
- API Key does not exist: Returns `{"success": false, "error": "..."}`
- Path does not exist: Returns error message
- Single file is not .md format: Returns error
- API call fails: Records to `errors` array, continues processing other files

**Output Format**:
The script returns results in JSON format:

```json
{
  "success": true,
  "synced_files": ["/path/to/file1.md", "/path/to/file2.md"],
  "errors": [],
  "pages_created": [
    {
      "type": "directory",
      "path": "/path/to/reports",
      "notion_page_id": "xxx",
      "url": "https://notion.so/xxx"
    },
    {
      "type": "file",
      "file": "/path/to/file1.md",
      "notion_page_id": "xxx",
      "url": "https://notion.so/xxx",
      "parent_directory": "reports"
    }
  ]
}

✅ Repository analysis completed!

📁 Analysis report location: /github-analysis/analysis-20240314-123045/reports/

📄 Generated files:
   - 01-Project Architecture Overview.md
   - 02-Code Quality Analysis.md
   - 03-Core Module Description.md

📊 Analysis Summary:
   - Tech Stack: Python/FastAPI + React
   - Code Files: 127
   - Main Issues: 3 potential issues found, see Code Quality Analysis report for details

🔄 Notion Synchronization: Synced to https://notion.so/xxx (if applicable)

❓ Delete cloned repository? (y/n)

undefined

undefined