k-cli-for-devs 1.0.0__tar.gz → 1.0.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (137) hide show
  1. {k_cli_for_devs-1.0.0/k_cli_for_devs.egg-info → k_cli_for_devs-1.0.2}/PKG-INFO +24 -5
  2. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/README.md +23 -4
  3. k_cli_for_devs-1.0.2/k_cli/agents/autonomous_agent.py +575 -0
  4. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/ui/simple_repl.py +10 -13
  5. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/web/server.py +27 -82
  6. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2/k_cli_for_devs.egg-info}/PKG-INFO +24 -5
  7. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli_for_devs.egg-info/SOURCES.txt +2 -0
  8. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/pyproject.toml +1 -1
  9. k_cli_for_devs-1.0.2/tests/test_autonomous_agent.py +78 -0
  10. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/LICENSE +0 -0
  11. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/MANIFEST.in +0 -0
  12. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/__init__.py +0 -0
  13. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/agents/__init__.py +0 -0
  14. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/agents/adversarial_swarm.py +0 -0
  15. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/agents/agent_core.py +0 -0
  16. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/agents/background_daemon.py +0 -0
  17. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/agents/orchestrator.py +0 -0
  18. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/agents/persona.py +0 -0
  19. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/agents/scaffold_engine.py +0 -0
  20. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/agents/strands_agent.py +0 -0
  21. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/agents/subagents.py +0 -0
  22. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/cli.py +0 -0
  23. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/__init__.py +0 -0
  24. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/airgap.py +0 -0
  25. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/credentials.py +0 -0
  26. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/intent_sensor.py +0 -0
  27. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/llm_driver.py +0 -0
  28. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/model_manager.py +0 -0
  29. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/models_hub.py +0 -0
  30. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/prompting.py +0 -0
  31. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/sdk.py +0 -0
  32. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/session.py +0 -0
  33. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/smart_router.py +0 -0
  34. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/storage_manager.py +0 -0
  35. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/core/viewport_engine.py +0 -0
  36. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/demo/demo_runner.py +0 -0
  37. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/git/__init__.py +0 -0
  38. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/git/ai_bisect.py +0 -0
  39. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/git/conflict_resolver.py +0 -0
  40. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/git/git_guard.py +0 -0
  41. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/git/patcher.py +0 -0
  42. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/git/repo_map.py +0 -0
  43. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/git/smart_git.py +0 -0
  44. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/git/verifier.py +0 -0
  45. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/github/__init__.py +0 -0
  46. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/github/dedup_engine.py +0 -0
  47. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/github/github_client.py +0 -0
  48. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/github/github_engine.py +0 -0
  49. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/github/local_hub.py +0 -0
  50. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/github/pr_watcher.py +0 -0
  51. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/github/trending.py +0 -0
  52. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/__init__.py +0 -0
  53. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/audit.py +0 -0
  54. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/chaos_immunity.py +0 -0
  55. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/codebase_qa.py +0 -0
  56. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/command_runner.py +0 -0
  57. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/diagram_generator.py +0 -0
  58. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/doc_retriever.py +0 -0
  59. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/feature.py +0 -0
  60. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/ghost_daemon.py +0 -0
  61. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/incident_triage.py +0 -0
  62. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/mcp_client.py +0 -0
  63. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/repo_gardener.py +0 -0
  64. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/rules.py +0 -0
  65. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/security.py +0 -0
  66. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/security_healer.py +0 -0
  67. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tools/synapse_graph.py +0 -0
  68. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tui/__init__.py +0 -0
  69. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tui/diff_viewer.py +0 -0
  70. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tui/tui.py +0 -0
  71. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tui/tui_animations.py +0 -0
  72. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/tui/tui_app.py +0 -0
  73. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/ui/__init__.py +0 -0
  74. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/web/__init__.py +0 -0
  75. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/web/static/app.js +0 -0
  76. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/web/static/index.html +0 -0
  77. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/web/static/monitor.html +0 -0
  78. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli/web/static/style.css +0 -0
  79. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli_for_devs.egg-info/dependency_links.txt +0 -0
  80. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli_for_devs.egg-info/entry_points.txt +0 -0
  81. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli_for_devs.egg-info/requires.txt +0 -0
  82. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/k_cli_for_devs.egg-info/top_level.txt +0 -0
  83. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/setup.cfg +0 -0
  84. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_adaptive_smart_router.py +0 -0
  85. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_adversarial_knowledge.py +0 -0
  86. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_adversarial_m6_patcher_git_session.py +0 -0
  87. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_challenger_m1_driver_and_mock.py +0 -0
  88. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_challenger_m1_streaming.py +0 -0
  89. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_chaos_immunity.py +0 -0
  90. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_cli.py +0 -0
  91. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_cli_fuzzer_traversal.py +0 -0
  92. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_cli_github_conflict_mcp.py +0 -0
  93. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_codex_hub.py +0 -0
  94. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_command_runner.py +0 -0
  95. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_conflict_resolver.py +0 -0
  96. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_credentials.py +0 -0
  97. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_dedup_engine.py +0 -0
  98. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_devdocs_expansion.py +0 -0
  99. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_diagram_generator.py +0 -0
  100. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_doc_retriever.py +0 -0
  101. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_dynamic_discovery_and_audit.py +0 -0
  102. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_e2e_suite.py +0 -0
  103. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_git_guard.py +0 -0
  104. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_github_client.py +0 -0
  105. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_github_engine.py +0 -0
  106. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_hackathon_bedrock_and_daemon.py +0 -0
  107. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_incident_triage.py +0 -0
  108. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_intent_sensor.py +0 -0
  109. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_k_cli_full_e2e.py +0 -0
  110. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_killer_features.py +0 -0
  111. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_llm_driver.py +0 -0
  112. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_local_hub.py +0 -0
  113. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_mcp_client.py +0 -0
  114. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_model_manager.py +0 -0
  115. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_models_hub.py +0 -0
  116. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_multi_provider_llm_driver.py +0 -0
  117. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_orchestrator.py +0 -0
  118. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_patcher.py +0 -0
  119. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_persona_system.py +0 -0
  120. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_repo_map.py +0 -0
  121. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_rules.py +0 -0
  122. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_sdk.py +0 -0
  123. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_security_healer.py +0 -0
  124. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_session.py +0 -0
  125. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_simple_ui_and_rules.py +0 -0
  126. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_smart_git.py +0 -0
  127. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_storage_manager.py +0 -0
  128. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_strands_agent.py +0 -0
  129. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_subagents.py +0 -0
  130. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_tui.py +0 -0
  131. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_tui_animations.py +0 -0
  132. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_tui_app.py +0 -0
  133. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_tui_app_screens.py +0 -0
  134. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_tui_pilot.py +0 -0
  135. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_verifier.py +0 -0
  136. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_viewport_engine.py +0 -0
  137. {k_cli_for_devs-1.0.0 → k_cli_for_devs-1.0.2}/tests/test_web_ui.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: k-cli-for-devs
3
- Version: 1.0.0
3
+ Version: 1.0.2
4
4
  Summary: K-CLI for Devs: Autonomous Self-Healing DevOps & Engineering Agent built with AWS Strands Agents SDK
5
5
  License: MIT License
6
6
 
@@ -56,11 +56,13 @@ Dynamic: license-file
56
56
 
57
57
  # ⚡ K-CLI for Devs: Verification-First Autonomous AI DevOps Workstation
58
58
 
59
- ### Engineered by **Krishiv Joshi** ([@krishivjoshi219-collab](https://github.com/krishivjoshi219-collab)) | AWS Builder ID: `krishivjoshi219-collab`
59
+ ### Engineered by **Krishiv Joshi** ([@krishivjoshi219-collab](https://github.com/krishivjoshi219-collab)) | AWS Builder ID: `krishivjoshi219@gmail.com`
60
60
  ### Built for the [AWS *Agents for Humans* Hackathon](https://agentsforhumans.devpost.com/) — *Professional Agents Track* ($40,000 Prize Pool)
61
61
 
62
62
  ---
63
63
 
64
+ [![PyPI Version](https://img.shields.io/pypi/v/k-cli-for-devs?color=blue&style=flat-square)](https://pypi.org/project/k-cli-for-devs/)
65
+ [![PyPI Install](https://img.shields.io/badge/pip-install%20k--cli--for--devs-blue?style=flat-square&logo=pypi&logoColor=white)](https://pypi.org/project/k-cli-for-devs/)
64
66
  [![MIT License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)
65
67
  [![Python 3.11+](https://img.shields.io/badge/Python-3.11%20%7C%203.12-brightgreen.svg?style=flat-square)](https://python.org)
66
68
  [![AWS Strands Agents](https://img.shields.io/badge/AWS-Strands%20Agents%20SDK-orange.svg?style=flat-square)](https://strandsagents.com)
@@ -69,6 +71,10 @@ Dynamic: license-file
69
71
  [![Architecture](https://img.shields.io/badge/Architecture-Verification--First%20AST-blueviolet.svg?style=flat-square)](#-zero-trust-ast-compiler-verification-guardrails)
70
72
  [![Offline Ready](https://img.shields.io/badge/Air--Gapped-100%25%20Offline%20Ready-teal.svg?style=flat-square)](#-sovereign-air-gapped-offline-engine)
71
73
 
74
+ ```bash
75
+ pip install k-cli-for-devs
76
+ ```
77
+
72
78
  > **K-CLI is the next-generation autonomous developer workstation that unites 3 unified UI tiers, zero-latency intent sensing, compiler-grounded AST verification, Google Antigravity-grade local shell execution, and AWS Bedrock AgentCore into a sovereign, production-grade CLI.**
73
79
 
74
80
  ---
@@ -262,6 +268,13 @@ K-CLI provides 3 purpose-built interfaces tailored to developer workflows:
262
268
 
263
269
  ## 🏛️ System Architecture Diagram
264
270
 
271
+ ![K-CLI System Architecture Diagram](docs/assets/architecture_diagram.png)
272
+
273
+ > 📄 **Official PDF Specification**: Download the vector [`docs/assets/architecture_diagram.pdf`](docs/assets/architecture_diagram.pdf) submitted to the AWS Hackathon.
274
+
275
+ <details>
276
+ <summary><b>Click to expand raw Mermaid flowchart specification</b></summary>
277
+
265
278
  ```mermaid
266
279
  flowchart TD
267
280
  subgraph Ingestion ["📥 Incident & Multi-Interface Ingestion Layer"]
@@ -313,16 +326,22 @@ flowchart TD
313
326
  Gate -- "Passed" --> Delivery
314
327
  ```
315
328
 
329
+ </details>
330
+
316
331
  ---
317
332
 
318
333
  ## 📦 Installation & Quickstart
319
334
 
320
- ### 1. Prerequisites
335
+ ### 1. Fast Install via PyPI (Recommended)
336
+ ```bash
337
+ pip install k-cli-for-devs
338
+ ```
339
+
340
+ ### 2. Prerequisites & Build from Source
321
341
  * **Python 3.11** or **Python 3.12**
322
342
  * **Git** installed on host machine
323
343
  * (Optional) **AWS Credentials** configured for Amazon Bedrock / Strands Agents
324
344
 
325
- ### 2. Clone and Install
326
345
  ```bash
327
346
  # Clone repository
328
347
  git clone https://github.com/krishivjoshi219-collab/K-Cli-for-Devs.git
@@ -456,6 +475,6 @@ The official submission video for the AWS "Agents for Humans" Hackathon is rende
456
475
 
457
476
  * **Author & Lead Architect**: **Krishiv Joshi**
458
477
  * **GitHub Profile**: [@krishivjoshi219-collab](https://github.com/krishivjoshi219-collab)
459
- * **AWS Builder ID**: `krishivjoshi219-collab`
478
+ * **AWS Builder ID**: `krishivjoshi219@gmail.com`
460
479
  * **Hackathon**: [AWS *Agents for Humans* Hackathon](https://agentsforhumans.devpost.com/) — Professional Agents Track
461
480
  * **License**: Open-source under the [MIT License](LICENSE).
@@ -1,10 +1,12 @@
1
1
  # ⚡ K-CLI for Devs: Verification-First Autonomous AI DevOps Workstation
2
2
 
3
- ### Engineered by **Krishiv Joshi** ([@krishivjoshi219-collab](https://github.com/krishivjoshi219-collab)) | AWS Builder ID: `krishivjoshi219-collab`
3
+ ### Engineered by **Krishiv Joshi** ([@krishivjoshi219-collab](https://github.com/krishivjoshi219-collab)) | AWS Builder ID: `krishivjoshi219@gmail.com`
4
4
  ### Built for the [AWS *Agents for Humans* Hackathon](https://agentsforhumans.devpost.com/) — *Professional Agents Track* ($40,000 Prize Pool)
5
5
 
6
6
  ---
7
7
 
8
+ [![PyPI Version](https://img.shields.io/pypi/v/k-cli-for-devs?color=blue&style=flat-square)](https://pypi.org/project/k-cli-for-devs/)
9
+ [![PyPI Install](https://img.shields.io/badge/pip-install%20k--cli--for--devs-blue?style=flat-square&logo=pypi&logoColor=white)](https://pypi.org/project/k-cli-for-devs/)
8
10
  [![MIT License](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](LICENSE)
9
11
  [![Python 3.11+](https://img.shields.io/badge/Python-3.11%20%7C%203.12-brightgreen.svg?style=flat-square)](https://python.org)
10
12
  [![AWS Strands Agents](https://img.shields.io/badge/AWS-Strands%20Agents%20SDK-orange.svg?style=flat-square)](https://strandsagents.com)
@@ -13,6 +15,10 @@
13
15
  [![Architecture](https://img.shields.io/badge/Architecture-Verification--First%20AST-blueviolet.svg?style=flat-square)](#-zero-trust-ast-compiler-verification-guardrails)
14
16
  [![Offline Ready](https://img.shields.io/badge/Air--Gapped-100%25%20Offline%20Ready-teal.svg?style=flat-square)](#-sovereign-air-gapped-offline-engine)
15
17
 
18
+ ```bash
19
+ pip install k-cli-for-devs
20
+ ```
21
+
16
22
  > **K-CLI is the next-generation autonomous developer workstation that unites 3 unified UI tiers, zero-latency intent sensing, compiler-grounded AST verification, Google Antigravity-grade local shell execution, and AWS Bedrock AgentCore into a sovereign, production-grade CLI.**
17
23
 
18
24
  ---
@@ -206,6 +212,13 @@ K-CLI provides 3 purpose-built interfaces tailored to developer workflows:
206
212
 
207
213
  ## 🏛️ System Architecture Diagram
208
214
 
215
+ ![K-CLI System Architecture Diagram](docs/assets/architecture_diagram.png)
216
+
217
+ > 📄 **Official PDF Specification**: Download the vector [`docs/assets/architecture_diagram.pdf`](docs/assets/architecture_diagram.pdf) submitted to the AWS Hackathon.
218
+
219
+ <details>
220
+ <summary><b>Click to expand raw Mermaid flowchart specification</b></summary>
221
+
209
222
  ```mermaid
210
223
  flowchart TD
211
224
  subgraph Ingestion ["📥 Incident & Multi-Interface Ingestion Layer"]
@@ -257,16 +270,22 @@ flowchart TD
257
270
  Gate -- "Passed" --> Delivery
258
271
  ```
259
272
 
273
+ </details>
274
+
260
275
  ---
261
276
 
262
277
  ## 📦 Installation & Quickstart
263
278
 
264
- ### 1. Prerequisites
279
+ ### 1. Fast Install via PyPI (Recommended)
280
+ ```bash
281
+ pip install k-cli-for-devs
282
+ ```
283
+
284
+ ### 2. Prerequisites & Build from Source
265
285
  * **Python 3.11** or **Python 3.12**
266
286
  * **Git** installed on host machine
267
287
  * (Optional) **AWS Credentials** configured for Amazon Bedrock / Strands Agents
268
288
 
269
- ### 2. Clone and Install
270
289
  ```bash
271
290
  # Clone repository
272
291
  git clone https://github.com/krishivjoshi219-collab/K-Cli-for-Devs.git
@@ -400,6 +419,6 @@ The official submission video for the AWS "Agents for Humans" Hackathon is rende
400
419
 
401
420
  * **Author & Lead Architect**: **Krishiv Joshi**
402
421
  * **GitHub Profile**: [@krishivjoshi219-collab](https://github.com/krishivjoshi219-collab)
403
- * **AWS Builder ID**: `krishivjoshi219-collab`
422
+ * **AWS Builder ID**: `krishivjoshi219@gmail.com`
404
423
  * **Hackathon**: [AWS *Agents for Humans* Hackathon](https://agentsforhumans.devpost.com/) — Professional Agents Track
405
424
  * **License**: Open-source under the [MIT License](LICENSE).