pi-apexlang 0.1.0

package/skills/apexlang/assets/routing-catalog-main.json

@@ -0,0 +1,179 @@
+{
+  "version": 2,
+  "package_profile": "public-product",
+  "description": "Compact public routing catalog. Resolve local session context before broader workflow reads.",
+  "prerequisite_routing": {
+    "applies_to": "db-backed and api-backed workflows that can continue from authoritative offline context",
+    "resolution_asset": "assets/workspace-intelligence.json",
+    "state_fields": [
+      "context_status",
+      "authoritative_offline_context",
+      "selected_source_class",
+      "selected_context_paths",
+      "connection_source",
+      "db_mode",
+      "db_connection_name",
+      "db_context.workspace.name",
+      "prereq_source"
+    ],
+    "source_precedence": [
+      "table_metadata",
+      "data_model",
+      "api_contract",
+      "requirements",
+      "live_db"
+    ],
+    "db_prompt_flow": {
+      "prompt_mode": "explicit_db_connection_and_workspace_flow",
+      "interactive_only": true,
+      "discovery_steps": [
+        "inspect_offline_schema_registry",
+        "scan_saved_sqlcl_connections"
+      ],
+      "metadata_preference": "prefer_authoritative_offline_context",
+      "required_live_inputs": [
+        "db_connection_name",
+        "db_context.workspace.name"
+      ],
+      "auto_bind_single_saved_connection": false,
+      "manual_entry": {
+        "input_name": "db_connection_name",
+        "companion_input_name": "apex_workspace_name",
+        "workspace_context_field": "db_context.workspace.name",
+        "prompt": "Provide db_connection_name and the corresponding APEX workspace name for this workflow."
+      },
+      "workspace_prompt": {
+        "input_name": "apex_workspace_name",
+        "context_field": "db_context.workspace.name",
+        "prompt": "Provide the APEX workspace name that corresponds to db_connection_name."
+      },
+      "multiple_connection_prompt": {
+        "source": "saved_sqlcl_connections",
+        "prompt_mode": "select_from_list",
+        "empty_list_prompt": "No saved SQLcl connections were found. Provide db_connection_name and the corresponding APEX workspace name if live DB context is still required, or continue only with authoritative offline metadata."
+      },
+      "offline_override": {
+        "prompt_mode": "explicit_opt_in",
+        "note": "Offline mode is selected only when the user explicitly asks for offline-only execution."
+      },
+      "offline_behavior": {
+        "disables_live_metadata_validation": true,
+        "disables_apex_validate": true,
+        "disables_apex_import": true
+      },
+      "workspace_selection": {
+        "prompt_mode": "explicit_workspace_name_required",
+        "persistence": "session_context_only",
+        "context_path": "APEXLANG_OUTPUT_ROOT/context-resolution.json",
+        "context_field": "db_context.workspace",
+        "materialization_behavior": "new-app materialize requires --workspace-name or session context populated from the user-provided workspace name"
+      }
+    }
+  },
+  "domains": [
+    {
+      "id": "apexlang",
+      "summary": "Oracle APEX and APEXlang generation, composition, debugging, and text-message localization work. When app/page scope appears with translation or language wording, prefer the shared-components translation workflow before generic page/app generation.",
+      "keywords": [
+        "apex",
+        "apexlang",
+        "create app",
+        "generate app",
+        "create app from fr and model",
+        "functional requirements",
+        "fr and model",
+        "page",
+        "region",
+        "item",
+        "button",
+        "dashboard",
+        "form",
+        "interactive report",
+        "interactive grid",
+        "translate",
+        "translation",
+        "translations",
+        "localize",
+        "localise",
+        "localization",
+        "localisation",
+        "internationalization",
+        "i18n",
+        "multilingual",
+        "language",
+        "languages",
+        "locale",
+        "locales",
+        "text message",
+        "text messages",
+        "messages.apx",
+        "app_text$"
+      ],
+      "intent_note": "App/page translation intent should route to shared-components text-message localization when prompts mention translation, localization, internationalization, multilingual, locale, language, APP_TEXT$, text messages, or messages.apx. Target language names and locale codes are validated by the translation workflow against the accepted APEX translation language list, not duplicated as router keywords.",
+      "load_first_path": "SKILL.md",
+      "load_next_paths": [
+        "../assets/apexlang/domains-catalog.json",
+        "../assets/workspace-intelligence.json"
+      ],
+      "required_inputs": [
+        "application scope",
+        "context_status"
+      ],
+      "needs_db": true,
+      "runtime_import_gate": {
+        "applies_to": "every APEXlang artifact generation, mutation, validation, debugging, or runtime workflow",
+        "prompt": "Default to checking APEXlang code only. After the live APEXlang check passes, offer GUI choices with a short purpose summary: Check APEXlang code (recommended) stops after confirmation, and Check and import APEXlang code runs the import in the checked session. If GUI choices are unavailable, stop after checking the code and report import as a follow-up.",
+        "choices": [
+          "Check APEXlang code",
+          "Check and import APEXlang code"
+        ],
+        "missing_input_behavior": "check_only_fallback"
+      }
+    },
+    {
+      "id": "screenshot-to-layout",
+      "summary": "Screenshot-driven APEX page composition with safe placeholders and optional DB context.",
+      "load_first_path": "references/domains/page-components/screenshot-to-layout.md",
+      "load_next_paths": [
+        "../assets/workspace-intelligence.json"
+      ],
+      "required_inputs": [
+        "image_path",
+        "application scope",
+        "page target",
+        "context_status"
+      ],
+      "needs_db": true,
+      "runtime_import_gate": {
+        "applies_to": "every generated or mutated APEXlang artifact from screenshot input",
+        "prompt": "Default to checking APEXlang code only. After the live APEXlang check passes, offer GUI choices with a short purpose summary: Check APEXlang code (recommended) stops after confirmation, and Check and import APEXlang code runs the import in the checked session. If GUI choices are unavailable, stop after checking the code and report import as a follow-up.",
+        "choices": [
+          "Check APEXlang code",
+          "Check and import APEXlang code"
+        ],
+        "missing_input_behavior": "check_only_fallback"
+      }
+    },
+    {
+      "id": "sqlcl",
+      "summary": "SQLcl connection handling and direct runtime/import workflows.",
+      "load_first_path": "references/ops/sqlcl.md",
+      "load_next_paths": [
+        "references/ops/runtime-gates.md"
+      ],
+      "required_inputs": [
+        "db_connection_name"
+      ],
+      "needs_db": true,
+      "runtime_import_gate": {
+        "applies_to": "every APEXlang artifact generation, mutation, validation, debugging, or runtime workflow",
+        "prompt": "Default to checking APEXlang code only. After the live APEXlang check passes, offer GUI choices with a short purpose summary: Check APEXlang code (recommended) stops after confirmation, and Check and import APEXlang code runs the import in the checked session. If GUI choices are unavailable, stop after checking the code and report import as a follow-up.",
+        "choices": [
+          "Check APEXlang code",
+          "Check and import APEXlang code"
+        ],
+        "missing_input_behavior": "check_only_fallback"
+      }
+    }
+  ]
+}

package/skills/apexlang/assets/routing-load-policy.json

@@ -0,0 +1,88 @@
+{
+  "version": 2,
+  "package_profile": "public-product",
+  "description": "Compact public loading policies. Prefer JSON assets and resolved context records before Markdown.",
+  "defaults": {
+    "max_initial_documents": 3,
+    "max_follow_on_documents": 3,
+    "prefer_machine_readable_catalogs": true,
+    "prefer_narrow_reference_packages": true,
+    "prefer_context_records": true
+  },
+  "tool_contract_note": "All `node tools/apexctl.mjs ...` commands are package-root relative: run them from the packaged skill root, or invoke that script by explicit path.",
+  "policies": [
+    {
+      "intent": "local context discovery",
+      "open_order": [
+        "assets/workspace-intelligence.json",
+        "node tools/apexctl.mjs workspace probe",
+        "the temp-runtime `context-resolution.json` report under `APEXLANG_OUTPUT_ROOT`, when present"
+      ],
+      "max_documents": 3
+    },
+    {
+      "intent": "top-level routing",
+      "open_order": [
+        "assets/routing-catalog-main.json",
+        "assets/routing-load-policy.json",
+        "assets/apexlang/domains-catalog.json"
+      ],
+      "max_documents": 3
+    },
+    {
+      "intent": "create app from FR and model",
+      "open_order": [
+        "SKILL.md",
+        "assets/workspace-intelligence.json",
+        "references/workflows/apexlang/workflow-create-app-from-fr-and-model.md",
+        "references/workflows/apexlang/application-spec.template.md"
+      ],
+      "required_decisions": [
+        "authoritative_requirements",
+        "authoritative_model_or_schema",
+        "application_spec"
+      ],
+      "max_documents": 4
+    },
+    {
+      "intent": "apexlang generation",
+      "open_order": [
+        "SKILL.md",
+        "assets/apexlang/domains-catalog.json",
+        "references/ops/runtime-gates.md",
+        "one matching reference or template"
+      ],
+      "required_decisions": [
+        "post_check_import_choice"
+      ],
+      "post_check_import_choice": {
+        "prompt": "Default to checking APEXlang code only. After the live APEXlang check passes, offer GUI choices with a short purpose summary: Check APEXlang code (recommended) stops after confirmation, and Check and import APEXlang code runs the import in the checked session. If GUI choices are unavailable, stop after checking the code and report import as a follow-up.",
+        "choices": [
+          "Check APEXlang code",
+          "Check and import APEXlang code"
+        ],
+        "unresolved": "check-only fallback"
+      },
+      "max_documents": 4
+    },
+    {
+      "intent": "runtime/import",
+      "open_order": [
+        "references/ops/sqlcl.md",
+        "references/ops/runtime-gates.md"
+      ],
+      "required_decisions": [
+        "post_check_import_choice"
+      ],
+      "post_check_import_choice": {
+        "prompt": "Default to checking APEXlang code only. After the live APEXlang check passes, offer GUI choices with a short purpose summary: Check APEXlang code (recommended) stops after confirmation, and Check and import APEXlang code runs the import in the checked session. If GUI choices are unavailable, stop after checking the code and report import as a follow-up.",
+        "choices": [
+          "Check APEXlang code",
+          "Check and import APEXlang code"
+        ],
+        "unresolved": "check-only fallback"
+      },
+      "max_documents": 3
+    }
+  ]
+}