add accela construct api wrapper

pos-module-accela_construct/CONTRIBUTE.md

@@ -0,0 +1,8 @@
+# Publish
+
+      git checkout master; git pull
+      pos-cli modules version x.x.x
+      git tag x.x.x
+      git push --tags; git push
+      pos-cli modules push --email your@email.com
+

pos-module-accela_construct/LICENSE

@@ -0,0 +1,20 @@
+Copyright platformOS and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

pos-module-accela_construct/changelog-template.hbs

@@ -0,0 +1,41 @@
+# Changelog
+
+All notable changes to this project will be documented in this file. Dates are displayed in UTC.
+
+{{#each releases}}
+  {{#if href}}
+    ## [{{title}}]({{href}})
+  {{else}}
+    ## {{title}}
+  {{/if}}
+
+  {{#if niceDate}}
+    > {{niceDate}}
+  {{/if}}
+
+  {{#if summary}}
+    {{summary}}
+  {{/if}}
+
+  ### Breaking changes
+  {{#each merges}}
+    {{#if commit.breaking}}- {{message}}{{#if href}} [`#{{id}}`]({{href}}){{/if}}{{/if}}
+  {{/each}}
+  {{#each fixes}}
+    {{#if commit.breaking}}- {{commit.subject}}{{#each fixes}}{{#if href}} [`#{{id}}`]({{href}}){{/if}}{{/each}}{{/if}}
+  {{/each}}
+  {{#each commits}}
+    {{#if breaking}}- {{subject}}{{#if href}} [`{{shorthash}}`]({{href}}){{/if}}{{/if}}
+  {{/each}}
+
+  ### Merged pull requests
+  {{#each merges}}
+    - {{message}}{{#if href}} [`#{{id}}`]({{href}}){{/if}}
+  {{/each}}
+
+  ### Fixes
+  {{#each fixes}}
+    - {{commit.subject}}{{#each fixes}}{{#if href}} [`#{{id}}`]({{href}}){{/if}}{{/each}}
+  {{/each}}
+
+{{/each}}

pos-module-accela_construct/modules/accela_construct/.mcp.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "platformos": {
+      "command": "pos-cli-mcp"
+    },
+    "platformos-supervisor": {
+      "command": "pos-cli-supervisor"
+    }
+  }
+}

pos-module-accela_construct/modules/accela_construct/CLAUDE.md

@@ -0,0 +1,30 @@
+
+<!-- BACKLOG.MD MCP GUIDELINES START -->
+<!-- backlog.md-instructions-version: 1.48.0 -->
+
+<CRITICAL_INSTRUCTION>
+
+## BACKLOG WORKFLOW INSTRUCTIONS
+
+This project uses Backlog.md MCP for all task and project management activities.
+
+**CRITICAL GUIDANCE**
+
+- If your client supports MCP resources, read `backlog://workflow/overview` to understand when and how to use Backlog for this project.
+- If your client only supports tools or the above request fails, call `backlog.get_backlog_instructions()` to load the tool-oriented overview. Use the `instruction` selector when you need `task-creation`, `task-execution`, or `task-finalization`.
+
+- **First time working here?** Read the overview resource IMMEDIATELY to learn the workflow
+- **Already familiar?** You should have the overview cached ("## Backlog.md Overview (MCP)")
+- **When to read it**: BEFORE creating tasks, or when you're unsure whether to track work
+
+These guides cover:
+- Decision framework for when to create tasks
+- Search-first workflow to avoid duplicates
+- Links to detailed guides for task creation, execution, and finalization
+- MCP tools reference
+
+You MUST read the overview resource to understand the complete workflow. The information is NOT summarized here.
+
+</CRITICAL_INSTRUCTION>
+
+<!-- BACKLOG.MD MCP GUIDELINES END -->

pos-module-accela_construct/modules/accela_construct/pos-module.json

@@ -0,0 +1,10 @@
+{
+  "name": "Accela Construct API Wrapper",
+  "machine_name": "accela_construct",
+  "version": "0.1.0",
+  "description": "platformOS module that wraps the Accela Construct API (v4) - Records and all its sub-resources (WorkflowTasks, Payments, Parcels, Owners, Inspections, Documents, Conditions, Addresses), Inspections (including Checklists and Conditions), and Searches - including OAuth2 password-grant token management with automatic refresh.",
+  "dependencies": {
+    "core": "^2.0.0",
+    "tests": "^1.3.4"
+  }
+}

pos-module-accela_construct/modules/accela_construct/public/api_calls/accela_generic.liquid

@@ -0,0 +1,17 @@
+---
+name: accela_generic
+delay: '0'
+format: https
+request_headers: >
+  {
+    "Content-Type": "application/json",
+    "Accept": "application/json",
+    "x-accela-appid": "{{ data.app_id }}",
+    "Authorization": "{{ data.access_token }}"
+  }
+request_type: "{{ data.request_type }}"
+to: >
+  {% function accela_base_url = 'modules/core/queries/constants/find', name: 'ACCELA_CONSTRUCT_BASE_URL' %}
+  {{ accela_base_url }}{{ data.path }}
+---
+{{ data.payload  }}

pos-module-accela_construct/modules/accela_construct/public/api_calls/accela_post_multipart.liquid

@@ -0,0 +1,18 @@
+---
+name: accela_post_multipart
+delay: '0'
+format: http
+request_headers: >
+  {
+    "x-accela-appid": "{{ data.app_id }}",
+    "Authorization": "{{ data.access_token }}"
+  }
+request_type: POST
+to: >
+  {% function accela_base_url = 'modules/core/queries/constants/find', name: 'ACCELA_CONSTRUCT_BASE_URL' %}
+  {{ accela_base_url }}{{ data.path }}
+---
+{
+  "uploadedFile": {{ data.file_field | json }},
+  "fileInfo": {{ data.file_info }}
+}

pos-module-accela_construct/modules/accela_construct/public/api_calls/accela_token_request.liquid

@@ -0,0 +1,13 @@
+---
+name: accela_token_request
+delay: '0'
+format: http
+request_headers: >
+  {
+    "Content-Type": "application/x-www-form-urlencoded",
+    "Accept": "application/json"
+  }
+request_type: POST
+to: "{{ data.auth_url }}"
+---
+{{ data.form_body }}

pos-module-accela_construct/modules/accela_construct/public/graphql/accela_oauth_token/create.graphql

@@ -0,0 +1,28 @@
+mutation accela_oauth_token_create(
+  $access_token: String!
+  $refresh_token: String
+  $expires_at: String!
+  $refresh_token_expires_at: String
+) {
+  record_create(
+    record: {
+      table: "modules/accela_construct/accela_oauth_token"
+      properties: [
+        { name: "access_token", value: $access_token }
+        { name: "refresh_token", value: $refresh_token }
+        { name: "expires_at", value: $expires_at }
+        { name: "refresh_token_expires_at", value: $refresh_token_expires_at }
+      ]
+    }
+  ) {
+    id
+    created_at
+    updated_at
+    table
+
+    access_token: property(name: "access_token")
+    refresh_token: property(name: "refresh_token")
+    expires_at: property(name: "expires_at")
+    refresh_token_expires_at: property(name: "refresh_token_expires_at")
+  }
+}

pos-module-accela_construct/modules/accela_construct/public/graphql/accela_oauth_token/find_latest.graphql

@@ -0,0 +1,19 @@
+query accela_oauth_token_find_latest {
+  records(
+    filter: { table: { value: "modules/accela_construct/accela_oauth_token" } }
+    sort: { created_at: { order: DESC } }
+    per_page: 1
+  ) {
+    results {
+      id
+      created_at
+      updated_at
+      table
+
+      access_token: property(name: "access_token")
+      refresh_token: property(name: "refresh_token")
+      expires_at: property(name: "expires_at")
+      refresh_token_expires_at: property(name: "refresh_token_expires_at")
+    }
+  }
+}

pos-module-accela_construct/modules/accela_construct/public/graphql/accela_oauth_token/update.graphql

@@ -0,0 +1,29 @@
+mutation accela_oauth_token_update(
+  $id: ID!
+  $access_token: String!
+  $refresh_token: String
+  $expires_at: String!
+  $refresh_token_expires_at: String
+) {
+  record_update(
+    id: $id
+    record: {
+      properties: [
+        { name: "access_token", value: $access_token }
+        { name: "refresh_token", value: $refresh_token }
+        { name: "expires_at", value: $expires_at }
+        { name: "refresh_token_expires_at", value: $refresh_token_expires_at }
+      ]
+    }
+  ) {
+    id
+    created_at
+    updated_at
+    table
+
+    access_token: property(name: "access_token")
+    refresh_token: property(name: "refresh_token")
+    expires_at: property(name: "expires_at")
+    refresh_token_expires_at: property(name: "refresh_token_expires_at")
+  }
+}

pos-module-accela_construct/modules/accela_construct/public/graphql/accela_request/create.graphql

@@ -0,0 +1,31 @@
+mutation accela_request_create(
+  $method: String!
+  $path: String!
+  $request_payload: String
+  $reference_id: String
+  $reference_schema: String
+) {
+  record_create(
+    record: {
+      table: "modules/accela_construct/accela_request"
+      properties: [
+        { name: "method", value: $method }
+        { name: "path", value: $path }
+        { name: "request_payload", value: $request_payload }
+        { name: "reference_id", value: $reference_id }
+        { name: "reference_schema", value: $reference_schema }
+      ]
+    }
+  ) {
+    id
+    created_at
+    updated_at
+    table
+
+    method: property(name: "method")
+    path: property(name: "path")
+    request_payload: property(name: "request_payload")
+    reference_id: property(name: "reference_id")
+    reference_schema: property(name: "reference_schema")
+  }
+}

pos-module-accela_construct/modules/accela_construct/public/graphql/accela_request/get.graphql

@@ -0,0 +1,19 @@
+query accela_request_get($id: ID!) {
+  records(
+    per_page: 1
+    filter: { id: { value: $id }, table: { value: "modules/accela_construct/accela_request" } }
+  ) {
+    results {
+      id
+      created_at
+      updated_at
+      table
+
+      method: property(name: "method")
+      path: property(name: "path")
+      request_payload: property(name: "request_payload")
+      reference_id: property(name: "reference_id")
+      reference_schema: property(name: "reference_schema")
+    }
+  }
+}

pos-module-accela_construct/modules/accela_construct/public/graphql/accela_request/list.graphql

@@ -0,0 +1,40 @@
+query accela_request_list(
+  $limit: Int!
+  $page: Int!
+  $method: String
+  $path: String
+  $reference_id: String
+  $reference_schema: String
+) {
+  records(
+    per_page: $limit
+    page: $page
+    filter: {
+      table: { value: "modules/accela_construct/accela_request" }
+      properties: [
+        { name: "method", value: $method }
+        { name: "path", value: $path }
+        { name: "reference_id", value: $reference_id }
+        { name: "reference_schema", value: $reference_schema }
+      ]
+    }
+    sort: [{ created_at: { order: DESC } }]
+  ) {
+    total_entries
+    has_next_page
+    current_page
+
+    results {
+      id
+      created_at
+      updated_at
+      table
+
+      method: property(name: "method")
+      path: property(name: "path")
+      request_payload: property(name: "request_payload")
+      reference_id: property(name: "reference_id")
+      reference_schema: property(name: "reference_schema")
+    }
+  }
+}

pos-module-accela_construct/modules/accela_construct/public/graphql/accela_request_response/create.graphql

@@ -0,0 +1,34 @@
+mutation accela_request_response_create(
+  $request_id: String!
+  $attempt_number: Int!
+  $status: Int
+  $response_body: String
+  $success: Boolean!
+  $error: String
+) {
+  record_create(
+    record: {
+      table: "modules/accela_construct/accela_request_response"
+      properties: [
+        { name: "request_id", value: $request_id }
+        { name: "attempt_number", value_int: $attempt_number }
+        { name: "status", value_int: $status }
+        { name: "response_body", value: $response_body }
+        { name: "success", value_boolean: $success }
+        { name: "error", value: $error }
+      ]
+    }
+  ) {
+    id
+    created_at
+    updated_at
+    table
+
+    request_id: property(name: "request_id")
+    attempt_number: property_int(name: "attempt_number")
+    status: property_int(name: "status")
+    response_body: property(name: "response_body")
+    success: property_boolean(name: "success")
+    error: property(name: "error")
+  }
+}