You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .kiro/specs/puppetdb-integration/design.md
+17-8Lines changed: 17 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,12 @@
2
2
3
3
## Overview
4
4
5
-
This design document outlines the architecture for version 0.2.0 of Padawi, transforming it from a Bolt-specific web interface into a general-purpose remote execution platform. The core architectural shift introduces a plugin-based integration system where PuppetDB serves as the first additional integration beyond Puppet Bolt. This establishes patterns and abstractions that will support future integrations with Ansible, Terraform, AWS CLI, Azure CLI, Kubernetes, and other infrastructure management tools.
5
+
This design document outlines the architecture for version 0.2.0 of Pabawi, transforming it from a
6
+
Bolt-specific web interface into a general-purpose remote execution platform. The core architectural
7
+
shift introduces a plugin-based integration system where PuppetDB serves as the first additional
8
+
integration beyond Puppet Bolt. This establishes patterns and abstractions that will support future
9
+
integrations with Ansible, Terraform, AWS CLI, Azure CLI, Kubernetes, and other infrastructure
Additionally, this version introduces action re-execution capabilities, allowing users to quickly repeat operations with preserved parameters, and comprehensive UI enhancements to support the multi-tool architecture.
21
26
22
-
**Expert Mode Enhancement**: A critical priority for this version is enhancing the expert mode experience to provide complete transparency into command execution. When expert mode is enabled, users will see the full command line being executed and complete, untruncated output (stdout/stderr). This visibility is essential for debugging, auditing, and understanding exactly what operations are being performed on managed infrastructure.
27
+
**Expert Mode Enhancement**: A critical priority for this version is enhancing the expert mode
28
+
experience to provide complete transparency into command execution. When expert mode is enabled,
29
+
users will see the full command line being executed and complete, untruncated output (stdout/stderr).
30
+
This visibility is essential for debugging, auditing, and understanding exactly what operations are
1.1 WHEN the system is configured with PuppetDB connection details THEN Padawi SHALL retrieve the list of active nodes from PuppetDB
513
+
1.1 WHEN the system is configured with PuppetDB connection details THEN Pabawi SHALL retrieve the list of active nodes from PuppetDB
505
514
Thoughts: This is about the system's ability to connect to PuppetDB and retrieve data. We can test this by generating random PuppetDB configurations (valid and invalid), attempting connections, and verifying that valid configs return node lists while invalid ones fail appropriately.
506
515
Testable: yes - property
507
516
@@ -601,7 +610,7 @@ Testable: yes - property
601
610
Thoughts: This is about filter functionality. We can verify all filter types work correctly.
602
611
Testable: yes - property
603
612
604
-
6.1 WHEN the system starts THEN Padawi SHALL read PuppetDB connection configuration from environment variables or configuration files
613
+
6.1 WHEN the system starts THEN Pabawi SHALL read PuppetDB connection configuration from environment variables or configuration files
605
614
Thoughts: This is about configuration loading. We can verify the system reads config from expected sources.
606
615
Testable: yes - example
607
616
@@ -1218,7 +1227,7 @@ UI tests will verify:
1218
1227
1219
1228
### New PuppetDB Endpoints
1220
1229
1221
-
```
1230
+
```http
1222
1231
GET /api/integrations/status
1223
1232
GET /api/integrations/puppetdb/nodes
1224
1233
GET /api/integrations/puppetdb/nodes/:certname
@@ -1232,7 +1241,7 @@ POST /api/integrations/puppetdb/query
1232
1241
1233
1242
### Enhanced Execution Endpoints
1234
1243
1235
-
```
1244
+
```http
1236
1245
GET /api/executions/:id/original # Get original execution for re-execution
1237
1246
GET /api/executions/:id/re-executions # Get all re-executions of an execution
1238
1247
POST /api/executions/:id/re-execute # Trigger re-execution
@@ -1244,7 +1253,7 @@ GET /api/executions/:id/command # Get full command line for executi
1244
1253
1245
1254
### Enhanced Inventory Endpoints
1246
1255
1247
-
```
1256
+
```http
1248
1257
GET /api/inventory?sources=bolt,puppetdb # Get inventory from specific sources
1249
1258
GET /api/inventory/sources # Get available inventory sources and status
Copy file name to clipboardExpand all lines: .kiro/specs/puppetdb-integration/requirements.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,13 +2,13 @@
2
2
3
3
## Introduction
4
4
5
-
This document specifies the requirements for version 0.2.0 of Padawi, a general-purpose remote execution interface that integrates multiple infrastructure management tools. This version adds PuppetDB as the first additional integration beyond Puppet Bolt, establishing patterns for future integrations with tools like Ansible, Terraform, AWS CLI, Azure CLI, and Kubernetes. PuppetDB will serve as both a dynamic inventory source for discovering nodes and as a rich data source for displaying node facts, Puppet run reports, catalogs, and events. This version also introduces task re-execution capabilities and UI enhancements to support the multi-tool architecture.
5
+
This document specifies the requirements for version 0.2.0 of Pabawi, a general-purpose remote execution interface that integrates multiple infrastructure management tools. This version adds PuppetDB as the first additional integration beyond Puppet Bolt, establishing patterns for future integrations with tools like Ansible, Terraform, AWS CLI, Azure CLI, and Kubernetes. PuppetDB will serve as both a dynamic inventory source for discovering nodes and as a rich data source for displaying node facts, Puppet run reports, catalogs, and events. This version also introduces task re-execution capabilities and UI enhancements to support the multi-tool architecture.
6
6
7
7
**Priority Focus:** A key priority for this version is enhancing the expert mode experience by ensuring full visibility of command execution details. When expert mode is enabled, users must be able to see the complete command line that was executed and the full, untruncated output (stdout/stderr). This transparency is critical for debugging, auditing, and understanding exactly what operations are being performed on managed infrastructure.
8
8
9
9
## Glossary
10
10
11
-
-**Padawi**: A general-purpose remote execution interface that integrates multiple infrastructure management tools (Bolt, PuppetDB, Ansible, Terraform, etc.)
11
+
-**Pabawi**: A general-purpose remote execution interface that integrates multiple infrastructure management tools (Bolt, PuppetDB, Ansible, Terraform, etc.)
12
12
-**PuppetDB**: A centralized storage service that collects and serves data generated by Puppet, including node facts, catalogs, reports, and events
13
13
-**Inventory Source**: A system or service that provides a list of nodes available for remote execution operations
14
14
-**Node Facts**: System information collected about managed nodes (OS, hardware, network configuration, etc.)
@@ -28,7 +28,7 @@ This document specifies the requirements for version 0.2.0 of Padawi, a general-
28
28
29
29
#### Acceptance Criteria
30
30
31
-
1. WHEN the system is configured with PuppetDB connection details THEN Padawi SHALL retrieve the list of active nodes from PuppetDB
31
+
1. WHEN the system is configured with PuppetDB connection details THEN Pabawi SHALL retrieve the list of active nodes from PuppetDB
32
32
2. WHEN PuppetDB returns node data THEN the system SHALL transform it into a normalized inventory format compatible with multiple execution tools
33
33
3. WHEN the inventory page loads THEN the system SHALL display nodes from PuppetDB alongside nodes from other inventory sources with clear source attribution
34
34
4. WHERE PuppetDB is configured as an inventory source THEN the system SHALL support filtering nodes by PuppetDB query language (PQL)
@@ -84,11 +84,11 @@ This document specifies the requirements for version 0.2.0 of Padawi, a general-
84
84
85
85
### Requirement 6
86
86
87
-
**User Story:** As an infrastructure administrator, I want to configure PuppetDB connection settings, so that I can connect Padawi to my PuppetDB instance securely.
87
+
**User Story:** As an infrastructure administrator, I want to configure PuppetDB connection settings, so that I can connect Pabawi to my PuppetDB instance securely.
88
88
89
89
#### Acceptance Criteria
90
90
91
-
1. WHEN the system starts THEN Padawi SHALL read PuppetDB connection configuration from environment variables or configuration files
91
+
1. WHEN the system starts THEN Pabawi SHALL read PuppetDB connection configuration from environment variables or configuration files
92
92
2. WHERE PuppetDB uses HTTPS THEN the system SHALL support SSL certificate validation with options for custom CA certificates
93
93
3. WHERE PuppetDB requires authentication THEN the system SHALL support token-based authentication
94
94
4. WHEN PuppetDB configuration is invalid THEN the system SHALL log detailed error messages for troubleshooting
Copy file name to clipboardExpand all lines: README.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
-
# Padawi
1
+
# Pabawi
2
2
3
3
Version 0.2.0 - Unified Remote Execution Interface
4
4
5
-
Padawi is a general-purpose remote execution platform that integrates multiple infrastructure management tools including Puppet Bolt and PuppetDB. It provides a unified web interface for managing infrastructure, executing commands, viewing system information, and tracking operations across your entire environment.
5
+
Pabawi is a general-purpose remote execution platform that integrates multiple infrastructure management tools including Puppet Bolt and PuppetDB. It provides a unified web interface for managing infrastructure, executing commands, viewing system information, and tracking operations across your entire environment.
Copy file name to clipboardExpand all lines: docs/puppetdb-api.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ Version: 0.2.0
4
4
5
5
## Overview
6
6
7
-
This document describes the API endpoints added in version 0.2.0 for PuppetDB integration, re-execution capabilities, and expert mode enhancements. These endpoints extend the base Padawi API to support multi-source infrastructure management.
7
+
This document describes the API endpoints added in version 0.2.0 for PuppetDB integration, re-execution capabilities, and expert mode enhancements. These endpoints extend the base Pabawi API to support multi-source infrastructure management.
0 commit comments