gamma-protocol 0.1.1__py3-none-any.whl
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.
|
File without changes
|
gamma_protocol/forge.py
ADDED
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
#!/usr/bin/env python3
|
|
2
|
+
import sys
|
|
3
|
+
import argparse
|
|
4
|
+
|
|
5
|
+
def forge_gamma(title, problem, solution, logic, source="gemini-cli", target="any"):
|
|
6
|
+
"""
|
|
7
|
+
Problem: Manual formatting of GAMMA traces leads to inconsistent headers and missing directives.
|
|
8
|
+
Solution: A Python-based Forge that enforces the PSC (Problem-Solution-Chain) architecture.
|
|
9
|
+
"""
|
|
10
|
+
digest = (
|
|
11
|
+
"This protocol mandates high-fidelity agentic action traces. Always maintain "
|
|
12
|
+
"strict problem-solution chains, documenting the 'why' before the 'how'. "
|
|
13
|
+
"Ensure every directive is autonomous, verifiable, and free of version suffixes. "
|
|
14
|
+
"Map deterministic targets using unified schemas. Execute terminal actions with "
|
|
15
|
+
"precision, registering every newly generated skill to the central ledger."
|
|
16
|
+
)
|
|
17
|
+
|
|
18
|
+
content = f"# GAMMA: {title}\n\n"
|
|
19
|
+
content += f"**agent-source**: {source}\n"
|
|
20
|
+
content += f"**agent-target**: {target}\n\n"
|
|
21
|
+
content += f"## 🤖 For Agents\n{digest}\n\n"
|
|
22
|
+
content += "## 1. Problem-Solution Architecture (The 'Why')\n\n"
|
|
23
|
+
content += f"**Q: What is the primary bottleneck for this action?**\n"
|
|
24
|
+
content += f"**Problem**: {problem}\n"
|
|
25
|
+
content += f"**Solution**: {solution}\n\n"
|
|
26
|
+
content += "## 2. Execution Logic & Finality\n"
|
|
27
|
+
content += f"**Logic**: {logic}\n\n"
|
|
28
|
+
content += "## 3. Rules & Constraints\n"
|
|
29
|
+
content += "- **Non-Suffix**: Overwrite existing files; no _v2 or _final.\n"
|
|
30
|
+
content += "- **Verifiability**: Action is incomplete until behavioral correctness is confirmed.\n"
|
|
31
|
+
|
|
32
|
+
filename = f"{title.lower().replace(' ', '_')}.gamma"
|
|
33
|
+
with open(filename, "w") as f:
|
|
34
|
+
f.write(content)
|
|
35
|
+
print(f"🔥 Successfully forged: {filename}")
|
|
36
|
+
|
|
37
|
+
def main():
|
|
38
|
+
parser = argparse.ArgumentParser(description="Forge a standardized GAMMA trace.")
|
|
39
|
+
parser.add_argument("--title", required=True)
|
|
40
|
+
parser.add_argument("--problem", required=True)
|
|
41
|
+
parser.add_argument("--solution", required=True)
|
|
42
|
+
parser.add_argument("--logic", required=True)
|
|
43
|
+
args = parser.parse_args()
|
|
44
|
+
forge_gamma(args.title, args.problem, args.solution, args.logic)
|
|
45
|
+
\nif __name__ == "__main__":\n main()
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: gamma-protocol
|
|
3
|
+
Version: 0.1.1
|
|
4
|
+
Summary: Standardized Guided Agentic Model-Mediated Actions (GAMMA) Forge Utility
|
|
5
|
+
Project-URL: Homepage, https://github.com/HNXJ/gamma-protocol
|
|
6
|
+
Project-URL: Issues, https://github.com/HNXJ/gamma-protocol/issues
|
|
7
|
+
Author: HNXJ
|
|
8
|
+
License: UNLICENSED
|
|
9
|
+
Keywords: agentic,gamma,gemini,mllm,protocol,psc
|
|
10
|
+
Classifier: Operating System :: OS Independent
|
|
11
|
+
Classifier: Programming Language :: Python :: 3
|
|
12
|
+
Requires-Python: >=3.7
|
|
13
|
+
Description-Content-Type: text/markdown
|
|
14
|
+
|
|
15
|
+
# GAMMA: Guided Agentic Model-Mediated Actions
|
|
16
|
+
|
|
17
|
+
**agent-source**: gemini-cli
|
|
18
|
+
**agent-target**: any
|
|
19
|
+
**subject**: readme-gamma
|
|
20
|
+
|
|
21
|
+
## 🤖 For Agents
|
|
22
|
+
This protocol mandates high-fidelity agentic action traces. Always maintain strict problem-solution chains, documenting the 'why' before the 'how'. Ensure every directive is autonomous, verifiable, and free of version suffixes. Map deterministic targets using unified schemas. Execute terminal actions with precision, registering every newly generated skill to the central ledger.
|
|
23
|
+
|
|
24
|
+
### 🧬 Skill vs. GAMMA: The Operational Distinction
|
|
25
|
+
|
|
26
|
+
| Feature | The Skill (e.g., `skills/`) | The GAMMA (e.g., `gamma.gamma`) |
|
|
27
|
+
| :--- | :--- | :--- |
|
|
28
|
+
| **Nature** | **Potential & Static**: A reusable "How-To" guide or capability definition. | **Kinetic & Active**: A specific, verifiable trace of a real-world architectural delta. |
|
|
29
|
+
| **Persistence** | **Permanent Knowledge**: Once registered, it resides in the agent's core toolbox for future use. | **Episodic Action**: Documents a single session's fix or implementation; it is a live history. |
|
|
30
|
+
| **Dependency** | **Standalone Capability**: Defines a tool or pattern (e.g., "how to parse LaTeX"). | **Mandatory Requirement**: If a GAMMA mentions a Skill, it **requires** its use. Otherwise explains the how-to part of it |
|
|
31
|
+
| **Objective** | **Enabling**: Focuses on increasing the agent's theoretical capacity. | **Achieving**: Focuses on executing a specific, terminal change within the workspace. |
|
|
32
|
+
| **Structure** | **Documentation + Logic**: Structured for retrieval and model learning. | **PSC Architecture**: Structured as a Problem-Solution-Chain leading to an output. |
|
|
33
|
+
|
|
34
|
+
## 1. Problem-Solution Architecture (The "Why")
|
|
35
|
+
|
|
36
|
+
**Q: Why do agents often lose context or fail during multi-step tasks?**
|
|
37
|
+
**Problem**: Traditional chat logs are non-deterministic and noisy. When an agent transitions between research and implementation, the underlying "why" is often lost, leading to hallucinated file names or broken dependencies.
|
|
38
|
+
**Solution**: Enforce a strict GAMMA trace. Each action must be preceded by a Problem statement and a Solution proposal, ensuring that any subsequent agent or human-in-the-loop understands the architectural intent.
|
|
39
|
+
|
|
40
|
+
**Q: How do we prevent the "version suffix" rot (e.g., script_v2.py)?**
|
|
41
|
+
**Problem**: Agents frequently create duplicate files to avoid errors, which violates workspace integrity and creates technical debt.
|
|
42
|
+
**Solution**: Implement a "No-Suffix" mandate. Agents must overwrite existing files and use Git for versioning. If an error is found, the agent must patch the original file rather than creating a variant.
|
|
43
|
+
|
|
44
|
+
## 2. Skill Generation & Registration
|
|
45
|
+
**Action**: Every new capability must be registered as a discrete skill within the `skills/` directory.
|
|
46
|
+
- **Logic**: Use a standardized format including `Description`, `Usage` (code snippet), and `Metadata`.
|
|
47
|
+
- **Registration**: Once a skill script is written, it must be registered to the central ledger (e.g., `gemini.md` or MCP schema) to ensure visibility to other agents.
|
|
48
|
+
|
|
49
|
+
## 3. Version Control & Deployment
|
|
50
|
+
**Action**: Synchronize the workspace after every successful GAMMA execution.
|
|
51
|
+
- **Git Protocol**: Strictly follow "Add -> Commit -> Push" to maintain a verifiable audit trail.
|
|
52
|
+
- **Ledger Update**: Reflect any changes in the project's root `gemini.md` to update the global workspace state.
|
|
53
|
+
|
|
54
|
+
## 4. Rules, Cautions & Limitations
|
|
55
|
+
- **Scientific Integrity**: Never hallucinate data or citations. Use verifiable sources only.
|
|
56
|
+
- **Deterministic Content**: Visual tools or layout evaluators must never alter empirical logic or mathematical equations.
|
|
57
|
+
- **Dependency Halts**: If a required system dependency is missing, halt and request a manual decision rather than attempting unsafe workarounds.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
gamma_protocol/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
|
2
|
+
gamma_protocol/forge.py,sha256=ULkuhcAb2SE1axzMjb2GJON19p1V19V-uzCUhtL4smg,2171
|
|
3
|
+
gamma_protocol-0.1.1.dist-info/METADATA,sha256=NO7WwDswuJ4bzkZRlpnK-Ob0BN0-ugwGf6MPLysZ4rk,4289
|
|
4
|
+
gamma_protocol-0.1.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
|
|
5
|
+
gamma_protocol-0.1.1.dist-info/entry_points.txt,sha256=cHTfyg7FEIFTpirEWVbjrRoRQ5LldVwZk1Mq5YcNMWo,61
|
|
6
|
+
gamma_protocol-0.1.1.dist-info/RECORD,,
|