autotouch-cli 0.2.40__tar.gz → 0.2.41__tar.gz

{autotouch_cli-0.2.40 → autotouch_cli-0.2.41}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.40
+Version: 0.2.41
 Summary: Autotouch Smart Table CLI
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown
@@ -137,7 +137,7 @@ Use a dedicated `AUTOTOUCH_CONFIG_PATH` if you want a clean local account instea
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.40/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.40/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.40/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.40/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.41/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.41/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.41/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.41/docs/platform/authentication.md

{autotouch_cli-0.2.40 → autotouch_cli-0.2.41}/README.md

@@ -128,7 +128,7 @@ Use a dedicated `AUTOTOUCH_CONFIG_PATH` if you want a clean local account instea
 
 ## Docs
 
-- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.40/docs/research-table/reference/autotouch-cli.md
-- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.40/docs/research-table/guides/autotouch-cli-agent-playbook.md
-- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.40/docs/research-table/reference/tables-api.md
-- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.40/docs/platform/authentication.md
+- Full CLI reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.41/docs/research-table/reference/autotouch-cli.md
+- Agent playbook: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.41/docs/research-table/guides/autotouch-cli-agent-playbook.md
+- Tables/API reference: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.41/docs/research-table/reference/tables-api.md
+- Authentication/scopes: https://github.com/nicolonic/autotouch_main/blob/autotouch-cli-v0.2.41/docs/platform/authentication.md

{autotouch_cli-0.2.40 → autotouch_cli-0.2.41}/autotouch_cli/cli_contracts.py

@@ -200,6 +200,9 @@ def output_contract(command_key: str, parser: argparse.ArgumentParser) -> Option
 
 
 def command_examples(parser: argparse.ArgumentParser) -> List[str]:
+    extra_examples = getattr(parser, "_codex_examples", None)
+    if isinstance(extra_examples, list) and extra_examples:
+        return [str(example) for example in extra_examples if str(example).strip()]
     usage = parser.format_usage().strip()
     if usage.startswith("usage: "):
         usage = usage[len("usage: ") :]
@@ -261,6 +264,8 @@ def collect_cli_command_manifest(
             "aliases": [],
             "group": path_parts[1] if len(path_parts) > 1 else None,
             "help": parser.description or parser.format_usage().strip(),
+            "description": parser.description,
+            "notes": parser.epilog,
             "required_flags": required_flags,
             "positionals": positionals,
             "options": options,
@@ -338,6 +343,10 @@ def build_cli_reference_markdown(manifest: Dict[str, Any]) -> str:
             if help_text:
                 lines.append(help_text)
                 lines.append("")
+            description = str(entry.get("description") or "").strip()
+            if description and description != help_text:
+                lines.append(description)
+                lines.append("")
             lines.append(f"- Auth: `{entry.get('auth_mode') or 'unknown'}`")
             lines.append(f"- Stability: `{entry.get('stability') or 'stable'}`")
             lines.append(f"- Destructive: `{'yes' if entry.get('destructive') else 'no'}`")
@@ -368,6 +377,13 @@ def build_cli_reference_markdown(manifest: Dict[str, Any]) -> str:
                 lines.append("- Example:")
                 for example in examples:
                     lines.append(f"  - `{example}`")
+            notes = str(entry.get("notes") or "").strip()
+            if notes:
+                lines.append("- Notes:")
+                lines.append("")
+                lines.append("```text")
+                lines.extend(notes.rstrip().splitlines())
+                lines.append("```")
             options = entry.get("options") or []
             if options:
                 lines.append("- Options:")

{autotouch_cli-0.2.40 → autotouch_cli-0.2.41}/autotouch_cli/commands/columns.py

@@ -286,7 +286,31 @@ def register_columns_subcommands(
     add_api_common_arguments(pcd)
     pcd.set_defaults(func=handlers["delete"])
 
-    pcpj = col_sub.add_parser("projections", help="Create JSON projection columns")
+    pcpj = col_sub.add_parser(
+        "projections",
+        help="Create JSON projection columns",
+        description=(
+            "Create JSON-split projection columns from a JSON source column.\n"
+            "Use this command for flattening enrichment JSON output into readable columns.\n"
+            "Do not use `autotouch columns create` with `kind: \"projection\"` and empty `config`."
+        ),
+        epilog=(
+            "CreateProjectionsRequest payload example:\n\n"
+            "{\n"
+            "  \"items\": [\n"
+            "    {\n"
+            "      \"key\": \"company_name\",\n"
+            "      \"label\": \"Company Name\",\n"
+            "      \"sourceColumnId\": \"<JSON_COLUMN_ID>\",\n"
+            "      \"path\": \"company_name\",\n"
+            "      \"dataType\": \"text\"\n"
+            "    }\n"
+            "  ]\n"
+            "}\n\n"
+            "Each item must include `key`, `label`, `sourceColumnId`, and `path`."
+        ),
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
     pcpj.add_argument("--table-id", required=True)
     pcpj.add_argument("--data-json", help="CreateProjectionsRequest payload JSON")
     pcpj.add_argument("--data-file", help="CreateProjectionsRequest payload file path")

{autotouch_cli-0.2.40 → autotouch_cli-0.2.41}/autotouch_cli/data/CLI_REFERENCE.md

@@ -1,6 +1,6 @@
 # Autotouch CLI Reference
 
-Generated from the installed parser for `autotouch-cli` `0.2.40`.
+Generated from the installed parser for `autotouch-cli` `0.2.41`.
 
 ## Output Modes
 
@@ -754,6 +754,10 @@ List table columns
 
 Create JSON projection columns
 
+Create JSON-split projection columns from a JSON source column.
+Use this command for flattening enrichment JSON output into readable columns.
+Do not use `autotouch columns create` with `kind: "projection"` and empty `config`.
+
 - Auth: `developer_key_or_user_session`
 - Stability: `stable`
 - Destructive: `no`
@@ -768,6 +772,25 @@ Create JSON projection columns
                                      [--output {json,ndjson,human}]
                                      [--compact] [--select SELECT |
                                      --json-pointer JSON_POINTER] [--verbose]`
+- Notes:
+
+```text
+CreateProjectionsRequest payload example:
+
+{
+  "items": [
+    {
+      "key": "company_name",
+      "label": "Company Name",
+      "sourceColumnId": "<JSON_COLUMN_ID>",
+      "path": "company_name",
+      "dataType": "text"
+    }
+  ]
+}
+
+Each item must include `key`, `label`, `sourceColumnId`, and `path`.
+```
 - Options:
   - `--table-id` (required)
   - `--data-json`: CreateProjectionsRequest payload JSON