decomposer: generate deliverable files for Define the normalized ingestion contract and pluggable source-connector interface for SCM, CMS, and other content sources.; Implement a GitHub SCM connector that conforms to the normalized ingestion contract and supports scoped full and incremental ingestion of Markdown, plain-text, and source files with webhook and revision metadata.; Implement a SharePoint CMS connector that conforms to the normalized ingestion contract and supports scoped full and incremental ingestion of PDF, DOCX, and HTML files with webhook and revision metadata.; Implement ingestion orchestration and triggers; Normalize, govern, and publish ingested content to the shared knowledge store.; Add deployment/configuration, tests, and documentation for the ingestion agent.; Validate end-to-end ingestion and downstream content availability.
Some checks failed
ci / test (push) Failing after 8s
Some checks failed
ci / test (push) Failing after 8s
This commit is contained in:
78
.agents/plans/wf-decompose-b4be4be4fd0c/DETAIL.md
Normal file
78
.agents/plans/wf-decompose-b4be4be4fd0c/DETAIL.md
Normal file
@@ -0,0 +1,78 @@
|
||||
# Plan Detail
|
||||
|
||||
## Step 0: Define the normalized ingestion contract and pluggable source-connector interface for SCM, CMS, and other content sources.
|
||||
|
||||
- **Capability:** Specify KAB-compatible connector inputs and outputs, normalized document structure, provenance, access controls, synchronization cursors, and trigger/configuration semantics.
|
||||
- **Plan label:** gap
|
||||
- **Reusable capability:** False
|
||||
- **Rationale:** This is the contract and interface for this deliverable; it is necessary to implement the requested agent but is not a separately discoverable capability beyond the agent repository.
|
||||
- **Input schema:** `{'goal': 'string', 'constraints': 'string[]'}`
|
||||
- **Output schema:** `{'ingestion_contract': 'object', 'connector_interface': 'object', 'normalized_document_schema': 'object', 'provenance_schema': 'object', 'access_control_schema': 'object', 'sync_cursor_schema': 'object', 'trigger_configuration_schema': 'object'}`
|
||||
- **Acceptance criteria:** (none)
|
||||
- **Success conditions:** (none)
|
||||
|
||||
## Step 1: Implement a GitHub SCM connector that conforms to the normalized ingestion contract and supports scoped full and incremental ingestion of Markdown, plain-text, and source files with webhook and revision metadata.
|
||||
|
||||
- **Capability:** Build a contract-compliant GitHub connector with repository and path scoping, authenticated retrieval, change-based synchronization, webhook-triggered updates, normalized documents, provenance, access controls, and synchronization cursors.
|
||||
- **Plan label:** gap
|
||||
- **Reusable capability:** False
|
||||
- **Rationale:** This is a source-specific implementation included in the requested agent’s first-version deliverable, not an independently reusable registry agent.
|
||||
- **Input schema:** `{'ingestion_contract': 'object', 'connector_interface': 'object', 'normalized_document_schema': 'object', 'provenance_schema': 'object', 'access_control_schema': 'object', 'sync_cursor_schema': 'object', 'trigger_configuration_schema': 'object'}`
|
||||
- **Output schema:** `{'github_connector': 'object', 'ingestion_contract': 'object', 'connector_interface': 'object'}`
|
||||
- **Acceptance criteria:** (none)
|
||||
- **Success conditions:** (none)
|
||||
|
||||
## Step 2: Implement a SharePoint CMS connector that conforms to the normalized ingestion contract and supports scoped full and incremental ingestion of PDF, DOCX, and HTML files with webhook and revision metadata.
|
||||
|
||||
- **Capability:** Build a contract-compliant SharePoint connector with site, library, folder, and file scoping; authenticated retrieval; change-based synchronization; webhook-triggered updates; normalized documents; provenance; access controls; and synchronization cursors.
|
||||
- **Plan label:** gap
|
||||
- **Reusable capability:** False
|
||||
- **Rationale:** This is a source-specific implementation included in the requested agent’s first-version deliverable, not an independently reusable registry agent.
|
||||
- **Input schema:** `{'ingestion_contract': 'object', 'connector_interface': 'object', 'normalized_document_schema': 'object', 'provenance_schema': 'object', 'access_control_schema': 'object', 'sync_cursor_schema': 'object', 'trigger_configuration_schema': 'object'}`
|
||||
- **Output schema:** `{'sharepoint_connector': 'object', 'ingestion_contract': 'object', 'connector_interface': 'object'}`
|
||||
- **Acceptance criteria:** (none)
|
||||
- **Success conditions:** (none)
|
||||
|
||||
## Step 3: Implement ingestion orchestration and triggers
|
||||
|
||||
- **Capability:** Coordinate KAB ingestion connectors for on-demand, scheduled, and webhook-triggered full or incremental synchronization, including retries, idempotency, run tracking, and dead-letter handling.
|
||||
- **Plan label:** gap
|
||||
- **Reusable capability:** False
|
||||
- **Rationale:** Orchestration is part of this standalone ingestion agent and coordinates its connectors; it is not being requested as a separately reusable platform capability.
|
||||
- **Input schema:** `{'ingestion_contract': 'object', 'connector_interface': 'object', 'github_connector': 'object', 'sharepoint_connector': 'object'}`
|
||||
- **Output schema:** `{'ingestion_orchestrator': 'object', 'ingestion_batch': 'object', 'sync_run_results': 'object', 'dead_letter_items': 'object'}`
|
||||
- **Acceptance criteria:** (none)
|
||||
- **Success conditions:** (none)
|
||||
|
||||
## Step 4: Normalize, govern, and publish ingested content to the shared knowledge store.
|
||||
|
||||
- **Capability:** Extract and normalize connector outputs, propagate ACLs and tenant isolation, use managed secrets, record audit events, apply retention and deletion rules, and publish governed documents for downstream platform agents.
|
||||
- **Plan label:** gap
|
||||
- **Reusable capability:** False
|
||||
- **Rationale:** These behaviors implement the requested agent’s downstream contract and governance requirements, so they remain deliverable content in the agent repository.
|
||||
- **Input schema:** `{'ingestion_batch': 'object', 'sync_run_results': 'object', 'dead_letter_items': 'object'}`
|
||||
- **Output schema:** `{'published_documents': 'object', 'knowledge_store_publication': 'object', 'audit_events': 'object', 'deletion_results': 'object', 'retention_results': 'object', 'publication_summary': 'object'}`
|
||||
- **Acceptance criteria:** (none)
|
||||
- **Success conditions:** (none)
|
||||
|
||||
## Step 5: Add deployment/configuration, tests, and documentation for the ingestion agent.
|
||||
|
||||
- **Capability:** Package the ingestion agent with CI/CD-aligned deployment configuration, connector and synchronization examples, automated contract and integration tests, and operational documentation covering setup, monitoring, recovery, security, and lifecycle management.
|
||||
- **Plan label:** gap
|
||||
- **Reusable capability:** False
|
||||
- **Rationale:** These are acceptance and operational artifacts for this specific agent deliverable, not standalone reusable registry capabilities.
|
||||
- **Input schema:** `{'published_documents': 'object', 'knowledge_store_publication': 'object', 'audit_events': 'object', 'deletion_results': 'object', 'retention_results': 'object', 'publication_summary': 'object'}`
|
||||
- **Output schema:** `{'deployment_configuration': 'object', 'ci_cd_workflow': 'object', 'configuration_examples': 'object', 'automated_test_results': 'object', 'operational_documentation': 'object', 'packaging_summary': 'object'}`
|
||||
- **Acceptance criteria:** (none)
|
||||
- **Success conditions:** (none)
|
||||
|
||||
## Step 6: Validate end-to-end ingestion and downstream content availability.
|
||||
|
||||
- **Capability:** Execute representative full, incremental, scheduled, and webhook-triggered flows across configured connectors, verify governed publication and downstream agent retrieval with tenant and ACL isolation, and report operational readiness.
|
||||
- **Plan label:** gap
|
||||
- **Reusable capability:** False
|
||||
- **Rationale:** (none recorded)
|
||||
- **Input schema:** `{'deployment_configuration': 'object', 'automated_test_results': 'object', 'operational_documentation': 'object', 'packaging_summary': 'object'}`
|
||||
- **Output schema:** `{'end_to_end_validation': 'object', 'downstream_access_validation': 'object', 'security_isolation_validation': 'object', 'operational_readiness': 'object', 'release_summary': 'object'}`
|
||||
- **Acceptance criteria:** (none)
|
||||
- **Success conditions:** (none)
|
||||
25
.agents/plans/wf-decompose-b4be4be4fd0c/MAP.md
Normal file
25
.agents/plans/wf-decompose-b4be4be4fd0c/MAP.md
Normal file
@@ -0,0 +1,25 @@
|
||||
# Plan Map
|
||||
|
||||
**Workflow:** wf-decompose-b4be4be4fd0c
|
||||
**Intent:** Create a new Kyndryl Agent Builder (KAB) agent that ingests data from a variety of sources — for example files held in source control management systems (SCM) and files held in content management systems (CMS) — and makes the ingested content available to downstream platform agents.
|
||||
**This repo covers:** step 0, step 1, step 2, step 3, step 4, step 5, step 6
|
||||
|
||||
## Dependency graph
|
||||
|
||||
- Step 0: no dependencies
|
||||
- Step 1: depends on step 0
|
||||
- Step 2: depends on step 0, step 1
|
||||
- Step 3: depends on step 0, step 1, step 2
|
||||
- Step 4: depends on step 3
|
||||
- Step 5: depends on step 4
|
||||
- Step 6: depends on step 5
|
||||
|
||||
## Phase table
|
||||
|
||||
Phase 1: step 0
|
||||
Phase 2: step 1
|
||||
Phase 3: step 2
|
||||
Phase 4: step 3
|
||||
Phase 5: step 4
|
||||
Phase 6: step 5
|
||||
Phase 7: step 6
|
||||
Reference in New Issue
Block a user