Lliam Enhancement Stack 02 - Add directory and domain (#176)

* Add FS utility.

* Add Lliam domain

Author: cpyle0819

aws_doc_sdk_examples_tools/lliam/README.md

@@ -0,0 +1,78 @@
+# Ailly Prompt Workflow
+
+This project automates the process of generating, running, parsing, and applying [Ailly](https://www.npmjs.com/package/@ailly/cli) prompt outputs to an AWS DocGen project. It combines all steps into one streamlined command using a single Python script.
+
+---
+
+## 📦 Overview
+
+This tool:
+1. **Generates** Ailly prompts from DocGen snippets.
+2. **Runs** Ailly CLI to get enhanced metadata.
+3. **Parses** Ailly responses into structured JSON.
+4. **Updates** your DocGen examples with the new metadata.
+
+All of this is done with one command.
+
+---
+
+## ✅ Prerequisites
+
+- Python 3.8+
+- Node.js and npm (for `npx`)
+- A DocGen project directory
+
+---
+
+## 🚀 Usage
+
+From your project root, run:
+
+```bash
+python -m aws_doc_sdk_examples_tools.agent.bin.main \
+  /path/to/your/docgen/project \
+  --system-prompts path/to/system_prompt.txt
+```
+
+### 🔧 Arguments
+
+- `iam_tributary_root`: Path to the root directory of your IAM policy tributary
+- `--system-prompts`: List of system prompt files or strings to include in the Ailly configuration
+- `--skip-generation`: Skip the prompt generation and Ailly execution steps (useful for reprocessing existing outputs)
+
+Run `python -m aws_doc_sdk_examples_tools.agent.bin.main update --help` for more info.
+
+---
+
+## 🗂 What This Does
+
+Under the hood, this script:
+
+1. Creates a directory `.ailly_iam_policy` containing:
+   - One Markdown file per snippet.
+   - A `.aillyrc` configuration file.
+
+2. Runs `npx @ailly/cli` to generate `.ailly.md` outputs.
+
+3. Parses the Ailly `.ailly.md` files into a single `iam_updates.json` file.
+
+4. Updates each matching `Example` in the DocGen instance with:
+   - `title`
+   - `title_abbrev`
+   - `synopsis`
+
+---
+
+## 💡 Example
+
+```bash
+python -m aws_doc_sdk_examples_tools.agent.bin.main \
+  ~/projects/AWSIAMPolicyExampleReservoir \
+  --system-prompts prompts/system_prompt.txt
+```
+
+This will:
+- Write prompts and config to `.ailly_iam_policy/`
+- Run Ailly and capture results
+- Parse and save output as `.ailly_iam_policy/iam_updates.json`
+- Apply updates to your DocGen examples

aws_doc_sdk_examples_tools/lliam/domain/commands.py

@@ -0,0 +1,26 @@
+from dataclasses import dataclass
+from pathlib import Path
+from typing import List
+
+
+class Command:
+    pass
+
+
+@dataclass
+class CreatePrompts(Command):
+    doc_gen_root: str 
+    system_prompts: List[str]
+    out_dir: str
+
+
+@dataclass
+class RunAilly(Command):
+    batches: List[str]
+
+
+@dataclass
+class UpdateReservoir(Command):
+    root: Path
+    batches: List[str]
+    packages: List[str]

aws_doc_sdk_examples_tools/lliam/domain/model.py

@@ -0,0 +1,15 @@
+from typing import List
+
+from aws_doc_sdk_examples_tools.doc_gen import Example, Snippet
+
+
+class Prompt:
+    def __init__(self, id: str, content: str):
+        self.id = id
+        self.content = content
+
+
+class Policies:
+    def __init__(self, examples: List[Example], snippets: List[Snippet]):
+        self.examples = examples
+        self.snippets = snippets

aws_doc_sdk_examples_tools/lliam/domain/operations.py

@@ -0,0 +1,28 @@
+import yaml
+from typing import List
+
+from aws_doc_sdk_examples_tools.lliam.domain.model import Prompt
+
+
+def build_ailly_config(system_prompts: List[Prompt]) -> Prompt:
+    """Create the .aillyrc configuration file."""
+    fence = "---"
+    options = {
+        "isolated": "true",
+        "overwrite": "true",
+        # MCP assistance did not produce noticeably different results, but it was
+        # slowing things down by 10x. Disabled for now.
+        # "mcp": {
+        #     "awslabs.aws-documentation-mcp-server": {
+        #         "type": "stdio",
+        #         "command": "uvx",
+        #         "args": ["awslabs.aws-documentation-mcp-server@latest"],
+        #     }
+        # },
+    }
+    options_block = yaml.dump(options).strip()
+    prompt_strs = [p.content for p in system_prompts]
+    prompts_block = "\n".join(prompt_strs)
+
+    content = f"{fence}\n{options_block}\n{fence}\n{prompts_block}"
+    return Prompt(".aillyrc", content)