velm 0.1.2__py3-none-any.whl

velm/core/cli/grimoire/_ai_rites.py

@@ -0,0 +1,247 @@
+# scaffold/core/cli/grimoire/_ai_rites.py
+"""The sacred rites for communing with the higher realms of intelligence."""
+from ..cli_utils import add_common_flags, add_variable_flags, add_simulation_flags
+import argparse
+
+RITES = {
+    "daemon": {
+        "module_path": "artisans.daemon_artisan",
+        "artisan_class_name": "DaemonArtisan",
+        "request_class_name": "DaemonRequest",
+        "help": "The High Priest of the Daemon. Manages the background Gnostic Nexus.",
+        "flags": [add_common_flags],
+        "subparsers": {
+            "start": {
+                    "help": "Awaken the Daemon in the current project sanctum.",
+                    "args": [
+                        ("--parent-pid", {"type": int, "help": "The PID of the creator."}),
+                        ("--pulse-file", {"help": "Path to the heartbeat file."}), # <--- ADD THIS
+                        ("--allow-remote", {"action": "store_true", "help": "Bind to 0.0.0.0."})
+                    ]
+            },
+            "stop": {"help": "Command the Daemon to enter a state of grace."},
+            "status": {"help": "Perceive the Daemon's current state of being."},
+            "logs": {"help": "Commune with the Daemon to hear its thoughts."},
+            "vigil": {"help": "Awaken the Daemon in Vigil mode, watching for file changes."},
+        }
+    },
+    "neural": {
+        "module_path": "artisans.neural",
+        "artisan_class_name": "NeuralArtisan",
+        "request_class_name": "NeuralRequest",
+        "help": "Open the Synaptic Console for AI configuration.",
+        "flags": [add_common_flags],
+    },
+    "query": {
+        "module_path": "artisans.query",
+        "artisan_class_name": "QueryArtisan",
+        "request_class_name": "QueryRequest",
+        "help": "The Gnostic Emissary. A universal, JSON-based query interface for AIs.",
+        "flags": [
+            add_common_flags,
+            lambda p: p.add_argument('--json', action='store_true', help='Ensure output is pure JSON for machine consumption.')
+        ],
+        "args": [("query", {"help": "The JSON-formatted plea from the AI."})]
+    },
+    "architect": {
+        "module_path": "artisans.architect",
+        "artisan_class_name": "ArchitectArtisan",
+        "request_class_name": "ArchitectRequest",
+        "help": "The AI Co-Architect. Evolves a project based on natural language intent.",
+        "flags": [add_common_flags, add_variable_flags],
+        "args": [("prompt", {"help": "The architect's intent for the project's evolution."})],
+    },
+    "manifest": {
+        "module_path": "artisans.manifest",
+        "artisan_class_name": "ManifestArtisan",
+        "request_class_name": "ManifestRequest",
+        "help": "The Neuromancer. Transmutes Natural Language into Structural Reality.",
+        "flags": [add_common_flags, add_variable_flags, add_simulation_flags],
+        "args": [("prompt", {"help": "The natural language plea for the new reality."})],
+    },
+    "introspect": {
+        "module_path": "artisans.introspect",
+        "artisan_class_name": "IntrospectionArtisan",
+        "request_class_name": "IntrospectionRequest",
+        "help": "The Oracle's Gaze. Proclaims the engine's internal capabilities.",
+        # [THE FIX]: We bestow the JSON vow upon the Introspector.
+        "flags": [
+            add_common_flags,
+            lambda p: p.add_argument('--json', action='store_true', help='Proclaim Gnosis as machine-readable JSON.')
+        ],
+        "args": [("topic", {"choices": ["all", "ui_components", "semantic_domains", "help_topics"], "help": "The Gnostic topic to introspect."})],
+    },
+    "vector": {
+        "module_path": "artisans.vector.artisan",
+        "artisan_class_name": "VectorArtisan",
+        "request_class_name": "VectorRequest",
+        "help": "Manage the project's semantic vector index (for RAG).",
+        "flags": [add_common_flags],
+        "subparsers": {
+            "index": {"help": "Scan and index the entire project."},
+            "query": {
+                "help": "Perform a semantic search.",
+                "args": [("query_text", {"help": "The natural language query."})]
+            },
+            "clear": {"help": "Annihilate the vector store."},
+        }
+    },
+    "resonate": {
+        "module_path": "artisans.resonate",
+        "artisan_class_name": "ResonateArtisan",
+        "request_class_name": "ResonateRequest",
+        "help": "Stop searching for strings. Search for *intent*.",
+        "flags": [add_common_flags],
+        "args": [("query", {"help": "The concept to search for."})],
+    },
+    "translate": {
+        "module_path": "artisans.translate",
+        "artisan_class_name": "TranslateArtisan",
+        "request_class_name": "TranslateRequest",
+        "help": "The Rosetta Stone. Transmutes code between tongues.",
+        "flags": [add_common_flags],
+        "args": [
+            ("source_path", {"help": "The source scripture to translate."}),
+            ("target_lang", {"help": "The target language (e.g., 'python', 'rust')."}),
+        ],
+    },
+    "dream": {
+        "module_path": "artisans.dream",
+        "artisan_class_name": "DreamArtisan",
+        "request_class_name": "DreamRequest",
+        "help": "The Oneiromancer. Transmutes natural language into a Gnostic Blueprint.",
+        "flags": [add_common_flags],
+        "args": [("prompt", {"help": "The natural language description of the desired architecture."})],
+    },
+    "muse": {
+        "module_path": "artisans.muse",
+        "artisan_class_name": "MuseArtisan",
+        "request_class_name": "MuseRequest",
+        "help": "The Prescient Muse. Predicts your next action and offers to perform it.",
+        "flags": [add_common_flags],
+        "args": [("context_file", {"nargs": "?", "help": "The file you are currently working on to provide context."})],
+    },
+    "agent": {
+        "module_path": "artisans.agent",
+        "artisan_class_name": "AgentArtisan",
+        "request_class_name": "AgentRequest",
+        "help": "The Conqueror. Unleashes an autonomous AI agent to fulfill a complex mission.",
+        "flags": [add_common_flags],
+        "args": [("mission", {"help": "The mission objective for the agent."})],
+    },
+    "scribe": {
+        "module_path": "artisans.scribe.conductor",
+        "artisan_class_name": "ScribeConductor",
+        "request_class_name": "ScribeRequest",
+        "help": "The Gnostic Scribe. Transmutes natural language into a Gnostic scripture.",
+        "flags": [
+            add_common_flags,
+            lambda p: p.add_argument('-o', '--output-path', help='Optional path to save the generated scripture.'),
+            lambda p: p.add_argument('--lang', dest='language', default='scaffold', choices=['scaffold', 'symphony', 'arch'], help='The sacred tongue of the prophecy.')
+        ],
+        "args": [("plea", {"help": "The natural language architectural plea."})],
+    },
+    "train": {
+        "module_path": "artisans.train",
+        "artisan_class_name": "TrainArtisan",
+        "request_class_name": "TrainRequest",
+        "help": "The Gnostic Forge. Trains a custom AI adapter on your codebase.",
+        "flags": [
+            add_common_flags,
+            lambda p: p.add_argument('--base-model', help="HuggingFace model ID to fine-tune."),
+            lambda p: p.add_argument('--epochs', type=int, help="Number of training epochs."),
+            lambda p: p.add_argument('--batch-size', type=int, help="Training batch size."),
+            lambda p: p.add_argument('--limit', type=int, dest='limit_samples', help="Limit number of training samples for testing."),
+        ],
+        "args": [("output_model_name", {"help": "Name of the resulting adapter."})],
+    },
+    "akasha": {
+        "module_path": "artisans.akasha.artisan",
+        "artisan_class_name": "AkashaArtisan",
+        "request_class_name": "AkashaRequest",
+        "help": "The Keeper of the Akasha. Manage the global Gnostic memory.",
+        "flags": [add_common_flags],
+        "subparsers": {
+            "stats": {"help": "View the vitality of the global memory."},
+            "query": {
+                "help": "Gaze into the Akasha for wisdom.",
+                "args": [("query", {"help": "The natural language query."})]
+            },
+            "purge": {"help": "Annihilate the global memory."},
+        }
+    },
+    "debate": {
+        "module_path": "artisans.hivemind.artisan",
+        "artisan_class_name": "HivemindArtisan",
+        "request_class_name": "DebateRequest",
+        "help": "The Hivemind. Summon a council of AI personas to debate a topic.",
+        "flags": [add_common_flags, add_variable_flags],
+        "args": [
+            ("topic", {"help": "The subject of the debate."}),
+            ("--with", {"dest": "personas", "nargs": "+", "default": ["architect", "security", "pragmatist"], "help": "Personas to summon (e.g., 'architect security')."}),
+            ("--rounds", {"type": int, "default": 1, "help": "Number of rebuttal rounds."}),
+            ("--blind", {"action": "store_true", "help": "If set, personas do not see each other's initial arguments."}),
+            ("--no-synthesis", {"dest": "synthesize", "action": "store_false", "help": "Skip the final summarization step."})
+        ],
+    },
+    "holocron": {
+        "module_path": "artisans.holocron.artisan",
+        "artisan_class_name": "HolocronArtisan",
+        "request_class_name": "HolocronRequest",
+        "help": "The Causal Context Engine. Maps execution paths to define perfect context.",
+        "flags": [add_common_flags],
+        "subparsers": {
+            "trace": {
+                "help": "Trace the static call graph from an entry point.",
+                "args": [
+                    ("entry_point", {"help": "The symbol or file to start from."}),
+                    ("--depth", {"type": int, "default": 5, "help": "How deep to traverse the graph."}),
+                ]
+            },
+            "slice": {
+                "help": "Surgically extract code related to a specific symbol.",
+                "args": [
+                    ("entry_point", {"help": "The symbol to focus on."}),
+                    ("--output", {"dest": "output_data", "help": "Where to save the slice."})
+                ]
+            },
+            "forge": {
+                "help": "Forge a Virtual Context based on a natural language problem description.",
+                "args": [
+                    ("entry_point", {"help": "The problem description (Intent)."}),
+                    ("--output", {"dest": "output_data", "help": "Where to save the virtual context."}),
+                    ("--depth", {"type": int, "default": 2, "help": "Graph traversal depth."})
+                ]
+            }
+        }
+    },
+
+    "ocular": {
+        "module_path": "artisans.ocular.artisan",
+        "artisan_class_name": "OcularArtisan",
+        "request_class_name": "OcularRequest",
+        "help": "The Ocular Cortex. Multimodal perception for UI engineering.",
+        "flags": [add_common_flags],
+        "subparsers": {
+            "gaze": {
+                "help": "Inspect a live URL and map pixels to code.",
+                "args": [
+                    ("--url", {"required": True, "help": "The URL to inspect."}),
+                    ("--target", {"dest": "target_element", "help": "Selector or text to find."})
+                ]
+            }
+        }
+    },
+
+    "aether": {
+        "module_path": "artisans.aether.artisan",
+        "artisan_class_name": "AetherArtisan",
+        "request_class_name": "AetherRequest",
+        "help": "The Neural Aether. Federated learning and pattern sharing.",
+        "flags": [add_common_flags],
+        "subparsers": {
+            "sync": {"help": "Download the latest wisdom from the mesh."},
+            "broadcast": {"help": "Share local patterns (anonymized) with the mesh."}
+        }
+    },
+}

velm/core/cli/grimoire/_automation_rites.py

@@ -0,0 +1,52 @@
+# scaffold/core/cli/grimoire/_automation_rites.py
+"""Rites for conducting workflows, orchestrating symphonies, and local vigilance."""
+from ..cli_utils import add_common_flags, add_variable_flags, add_simulation_flags
+import argparse
+
+RITES = {
+    "symphony": {
+        "module_path": "artisans.symphony",
+        "artisan_class_name": "SymphonyArtisan",
+        "request_class_name": "SymphonyRequest",
+        "help": "The Sovereign Conductor. Orchestrates complex executable workflows.",
+        "flags": [add_common_flags, add_variable_flags, add_simulation_flags],
+        "args": [
+            ("symphony_command", {"choices": ["conduct", "debug"], "help": "The symphonic rite to perform."}),
+            ("symphony_path", {"nargs": "?", "help": "Path to the .symphony scripture."})
+        ],
+    },
+    "watch": {
+        "module_path": "artisans.watchman",
+        "artisan_class_name": "WatchmanArtisan",
+        "request_class_name": "WatchmanRequest",
+        "help": "The Watchman. Sentinel of local vigilance and auto-execution.",
+        "flags": [add_common_flags],
+        "args": [
+            ("glob_pattern", {"help": "The profile name or glob pattern to watch."}),
+            ("command_to_run", {"nargs": "?", "help": "The shell command to execute on change."})
+        ],
+    },
+    "save": {
+        "module_path": "artisans.save_artisan",
+        "artisan_class_name": "SaveArtisan",
+        "request_class_name": "SaveRequest",
+        "help": "The Neural Scribe. Generates intent-driven commits and self-heals.",
+        "flags": [add_common_flags],
+        "args": [("intent", {"help": "The natural language intent for this save point."})],
+    },
+    "changelog": {
+        "module_path": "artisans.changelog.artisan",
+        "artisan_class_name": "ChangelogArtisan",
+        "request_class_name": "ChangelogRequest",
+        "help": "The Chronicle Scribe. Transmutes git history into a CHANGELOG.md.",
+        "flags": [add_common_flags],
+    },
+    "ci-optimize": {
+        "module_path": "artisans.ci_optimize",
+        "artisan_class_name": "OptimizeCIArtisan",
+        "request_class_name": "OptimizeCIRequest",
+        "help": "The Self-Mutating CI. Analyzes telemetry to optimize workflow speeds.",
+        "flags": [add_common_flags],
+        "args": [("workflow_path", {"help": "Path to the CI workflow YAML to optimize."})],
+    },
+}

velm/core/cli/grimoire/_core_rites.py

@@ -0,0 +1,244 @@
+# Gnostic Codex: scaffold/core/cli/grimoire/_core_rites.py
+# --------------------------------------------------------
+# LIF: 100,000,000,000 (THE APOTHEOSIS OF WILL)
+#
+# HERESY ANNIHILATED: The Mute Vow
+#
+# The `create` rite's scripture in the Grimoire has been ascended. It is now
+# taught to perceive the sacred `--raw` vow. This forges the final, unbreakable
+# Gnostic link between the Architect's spoken plea and the engine's soul,
+# allowing for absolute, explicit control over the nature of creation.
+
+"""The foundational rites of creation and execution."""
+from ..cli_utils import add_common_flags, add_simulation_flags, add_variable_flags
+import argparse
+
+# --- A NEW, SPECIALIZED SCRIBE FOR THE `create` RITE ---
+def add_create_flags(parser: argparse.ArgumentParser):
+    """Bestows the unique vows for the `create` artisan."""
+    group = parser.add_argument_group("Creation Modifiers")
+
+    # [ASCENSION I] The Path of Pure Will
+    group.add_argument(
+        '--raw',
+        action='store_true',
+        help='The Vow of Raw Creation. Bypasses all templates and uses content from --set content directly.'
+    )
+    group.add_argument(
+        '--dir',
+        action='store_true',
+        help='Explicitly forge a directory, even if the path does not end with a slash.'
+    )
+
+    # [ASCENSION II] The Sentient Hand
+    # Allows the architect to guide the creation with natural language immediately.
+    # nargs='?' allows: --ai-edit (True) OR --ai-edit "Make it fast" (String)
+    group.add_argument(
+        '--ai-edit',
+        nargs='?',
+        const=True,
+        help='Summon the Neural Cortex to transmute the template. Provide a prompt or leave empty for interactive mode.'
+    )
+
+    # [ASCENSION III] Governance & Silence
+    group.add_argument(
+        '--no-open',
+        action='store_true',
+        help='Suppress the auto-opening of the file in the editor.'
+    )
+    group.add_argument(
+        '--no-tests',
+        action='store_true',
+        help='Suppress the generation of shadow twin (test) files.'
+    )
+    group.add_argument(
+        '--no-assemble',
+        action='store_true',
+        help='The Vow of Isolation. Prevents the Gnostic Assembler from wiring this file into the project graph.'
+    )
+
+    # [ASCENSION IV] The Sources of Matter
+    group.add_argument(
+        '--needs',
+        nargs='*',
+        help='A list of system dependencies (e.g., git, docker) required for this creation to be pure.'
+    )
+    group.add_argument(
+        '--teach',
+        help='Teach the created file as a new template for the specified extension (e.g., `py`).'
+    )
+    group.add_argument(
+        '--edit',
+        '-e',
+        action='store_true',
+        help='Open the newly forged scriptures in your default editor.'
+    )
+    group.add_argument(
+        '--from-url',
+        help='Summon the scripture\'s soul from a celestial URL.'
+    )
+    group.add_argument(
+        '--paste',
+        '-c',
+        action='store_true',
+        help='Summon the scripture\'s soul from the system clipboard.'
+    )
+    group.add_argument(
+        '--from-stdin',
+        action='store_true',
+        help='Summon the scripture\'s soul from the stdin stream.'
+    )
+    group.add_argument(
+        '--of',
+        nargs='+',
+        help="The Rite of Semantic Forging (e.g., `component:Button`)."
+    )
+    group.add_argument(
+        '--kit',
+        help="Weave an entire Gnostic Kit from the Forge."
+    )
+
+RITES = {
+    "genesis": {
+        "module_path": "artisans.genesis",
+        "artisan_class_name": "GenesisArtisan",
+        "request_class_name": "GenesisRequest",
+        "help": "The Rite of Genesis. Forges a new reality from a blueprint.",
+        "description": "The `genesis` command is the Alpha. It takes a `.scaffold` blueprint and materializes it, running the full interactive dialogue if needed.",
+        "flags": [add_common_flags, add_simulation_flags, add_variable_flags],
+        "args": [("blueprint_path", {"nargs": "?", "default": ".", "help": "Path to the .scaffold blueprint or an archetype name."})],
+    },
+    "init": {
+        "module_path": "artisans.init",
+        "artisan_class_name": "InitArtisan",
+        "request_class_name": "InitRequest",
+        "help": "The Rite of Inception. Begins the Sacred Dialogue to forge a new project.",
+        "flags": [add_common_flags, add_variable_flags],
+        "args": [("profile", {"nargs": "?", "help": "The name of the Gnostic Archetype to use (e.g., 'fastapi-service')."})],
+    },
+    "run": {
+        "module_path": "artisans.run.conductor",
+        "artisan_class_name": "RunArtisan",
+        "request_class_name": "RunRequest",
+        "help": "The Universal Conductor. Executes any scripture (.py, .js, .symphony, .scaffold).",
+        "flags": [add_common_flags, add_variable_flags],
+        "args": [
+            ("target", {"help": "The scripture to run (e.g., 'main.py', 'deploy.symphony')."}),
+            ("extra_args", {"nargs": argparse.REMAINDER, "help": "Arguments to pass to the script."}),
+        ],
+    },
+     "create": {
+        "module_path": "artisans.create",
+        "artisan_class_name": "CreateArtisan",
+        "request_class_name": "CreateRequest",
+        "help": "The Rite of Ad-Hoc Creation. Forges a file from a template or the void.",
+        "description": "Materializes new files. Can summon templates, use clipboard content, or download from URLs. Supports AI transmutation via --ai-edit.",
+        "flags": [
+            add_common_flags,
+            add_simulation_flags,  # [ASCENSION]: Enables --preview / --dry-run
+            add_variable_flags,
+            # [ASCENSION]: Inline content injection
+            lambda p: p.add_argument('--content', help='Bestow a soul (content) upon the new scripture directly from the command line.'),
+            add_create_flags
+        ],
+        "args": [("paths", {"nargs": "+", "help": "Path(s) to the file(s) or directory to create."})],
+    },
+    "teach": {
+        "module_path": "artisans.tutorial.artisan",
+        "artisan_class_name": "TutorialArtisan",
+        "request_class_name": "TeachRequest",
+        "help": "The Tutorial Forge. Gamified onboarding and interactive learning.",
+        "flags": [add_common_flags],
+        "subparsers": {
+            "generate": {
+                "help": "Analyze codebase and forge a new curriculum.",
+                "args": [("--topic", {"help": "Focus area."}), ("--difficulty", {"choices": ["novice", "adept"], "default": "novice"})]
+            },
+            "start": {"help": "Begin the next quest in the active curriculum."},
+            "verify": {"help": "Check if the current quest objective is met."}
+        }
+    },
+    "resurrect": {
+        "module_path": "artisans.lazarus.artisan",
+        "artisan_class_name": "LazarusArtisan",
+        "request_class_name": "LazarusRequest",
+        "help": "The Lazarus Protocol. Automatically diagnose and fix crashes.",
+        "flags": [add_common_flags],
+        "args": [
+            ("command", {"help": "The command that triggers the crash (e.g. 'pytest')."}),
+            ("--auto-apply", {"action": "store_true", "help": "Apply the fix without asking."})
+        ]
+    },
+    "fortify": {
+        "module_path": "artisans.fortress.artisan",
+        "artisan_class_name": "FortressArtisan",
+        "request_class_name": "FortressRequest",
+        "help": "The Fortress. Scan for vulnerabilities and harden code.",
+        "flags": [add_common_flags],
+        "args": [("--fix", {"action": "store_true", "help": "Attempt auto-patching."})]
+    },
+    "port": {
+        "module_path": "artisans.babel.artisan",
+        "artisan_class_name": "BabelArtisan",
+        "request_class_name": "BabelRequest",
+        "help": "The Babel Engine. Port code to a new language.",
+        "flags": [add_common_flags],
+        "args": [
+            ("source", {"help": "File to port."}),
+            ("--to", {"dest": "target_lang", "choices": ["rust", "go", "python", "typescript"], "required": True, "help": "Target language."}),
+            ("--fuse", {"dest": "fusion_bind", "action": "store_true", "help": "Auto-compile and bind using Fusion."})
+        ]
+    },
+    "observatory": {
+        "module_path": "artisans.observatory",
+        "artisan_class_name": "ObservatoryArtisan",
+        "request_class_name": "ObservatoryRequest",
+        "help": "The Gnostic Observatory. Manage the multi-project cosmos.",
+        "flags": [
+            add_common_flags,
+            lambda p: p.add_argument('--json', dest='json_mode', action='store_true', help='Output in JSON format.')
+        ],
+        "subparsers": {
+            "list": {"help": "List all registered projects."},
+            "add": {
+                "help": "Register a project.",
+                "args": [("target", {"help": "Path to the project root.", "nargs": "?"})]
+            },
+            "switch": {
+                "help": "Switch active context.",
+                "args": [("target", {"help": "Project Name or ID."})]
+            },
+            "discover": {
+                "help": "Scan for unmanaged projects.",
+                "args": [("target", {"help": "Root directory to scan.", "nargs": "?"})]
+            },
+            "prune": {"help": "Remove missing projects from registry."},
+            "active": {"help": "Show current active project."},
+            "open": {"help": "Open active project in editor."}
+        }
+    },
+
+    "simulate": {
+        "module_path": "artisans.simulacrum.artisan",
+        "artisan_class_name": "SimulacrumArtisan",
+        "request_class_name": "SimulateRequest",
+        "help": "Executes code in a disposable, project-aware Void Sanctum.",
+        "description": "The Simulacrum allows for ephemeral execution of code snippets within the context of the project. It bridges dependencies (node_modules, venv) but isolates side-effects to a temporary directory.",
+        "flags": [add_common_flags],
+        "args": [
+            ("target_file", {"nargs": "?", "help": "Path to a local file to read content from."}),
+            ("--content", {"help": "Inline code content to simulate (overrides target_file)."}),
+            ("--lang", {"dest": "language", "help": "Force specific language runtime (e.g. 'python', 'ts')."}),
+            ("--timeout", {"type": int, "default": 60, "help": "Maximum duration (seconds) before the void collapses."}),
+            ("--env", {"action": "append", "help": "Inject env vars (KEY=VALUE)."})
+        ]
+    },
+    "lsp": {
+            "module_path": "core.lsp.scaffold_server",
+            "artisan_class_name": "GnosticLSPRequest", # Direct class usage
+            "request_class_name": "BaseRequest", # Dummy request, we don't use Dispatcher
+            "help": "Starts the Gnostic Language Server (Stdio Mode).",
+            "flags": [],
+            "handler": lambda engine, args: _run_lsp_mode()
+    },
+}