Sysop: pushed from media by wikipush

2026-03-19T05:42:39Z

pushed from media by wikipush

New page

= Ypgen - Y-Principle Generator =

'''ypgen''' (py-yprinciple-gen) is a Python-based code generator that applies the [https://wiki.bitplan.com/index.php/Y-Principle Y-Principle] to automatically generate [https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki Semantic MediaWiki] infrastructure from a single model definition.

* GitHub: https://github.com/WolfgangFahl/py-yprinciple-gen
* PyPI: [https://pypi.org/project/py-yprinciple-gen/ py-yprinciple-gen]
* Web UI: https://ypgen.bitplan.com
* Version: 0.5.2 (2026-02-23)
* License: Apache 2.0

== The Y-Principle ==

The Y-Principle states: '''Define once, generate everything.'''

Instead of manually creating wiki Templates, Forms, Categories, Concepts, Properties, and Help pages for each topic, you define the data model once in a '''Context''' using the SiDIF (Simple Data Interchange Format) notation. Ypgen then generates all necessary wiki pages from that single definition.

<pre>
Context (SiDIF Model)
|
ypgen
|
+--------+--------+--------+--------+--------+
| | | | | |
Template Form Category Concept Properties Help
</pre>

This eliminates redundancy, ensures consistency, and makes changes propagate automatically across all generated artifacts.

== How It Works ==

=== 1. Define a Context ===

A Context is a data model defined in SiDIF notation on [https://contexts.bitplan.com contexts.bitplan.com]. It contains:
* '''Topics''' - The things you want to model (e.g., Agent, Mail, Scholar)
* '''Properties''' - The attributes of each topic (e.g., name, role, since)
* '''Metadata''' - Type, input type, bounds, documentation, display options

Example: The [https://contexts.bitplan.com/index.php/AgentContext AgentContext] defines the '''Agent''' topic with properties like name, role, DISC scores, etc.

<source lang="java">
Agent isA Topic
"Agent" is name of it
"Agents" is pluralName of it
"AI Assistant that performs tasks autonomously" is documentation of it
"property" is defaultstoremode of it

Agent_name addsTo it
Agent_role addsTo it
Agent_dominance addsTo it
...
</source>

=== 2. Run ypgen ===

<source lang="bash">
# Generate wiki infrastructure and serve the web UI
ypgen --context AgentContext --wikiId media --serve

# Or generate for a specific wiki without web server
ypgen --context AgentContext --wikiId media
</source>

Command-line options:
{| class="wikitable"
! Option !! Default !! Description
|-
| <code>--context CONTEXT</code> || MetaModel || Context to generate from
|-
| <code>--wikiId WIKIID</code> || wiki || Target wiki ID (from ~/.mediawiki-japi/ config)
|-
| <code>--serve</code> || false || Start web server for review UI
|-
| <code>--host HOST</code> || fix.bitplan.com || Host to serve from
|-
| <code>--port PORT</code> || 8778 || Port to serve from
|-
| <code>-d</code> || false || Debug mode
|}

=== 3. Review Generated Pages ===

The web UI at [https://ypgen.bitplan.com ypgen.bitplan.com] shows all generated wiki pages side-by-side before pushing them to the target wiki. You can review:
* '''Template:Agent''' - The Semantic MediaWiki template with all properties
* '''Form:Agent''' - The form for creating/editing agent pages
* '''Category:Agent''' - The category page
* '''Concept:Agent''' - The SMW concept definition
* '''Property:Agent *''' - Individual property pages
* '''Help:Agent''' - Auto-generated help page

=== 4. Push to Wiki ===

After review, the generated pages are pushed to the target wiki (e.g., media.bitplan.com). Users can then create pages using the generated templates and forms.

== What Gets Generated ==

For each '''Topic''' in a Context, ypgen generates:

{| class="wikitable"
! Wiki Page !! Purpose !! Example
|-
| <code>Template:{Topic}</code> || Stores and displays semantic properties || Template:Agent
|-
| <code>Form:{Topic}</code> || User-friendly input form || Form:Agent
|-
| <code>Category:{Topic}</code> || Groups all instances || Category:Agent
|-
| <code>Concept:{Topic}</code> || SMW concept for querying || Concept:Agent
|-
| <code>Help:{Topic}</code> || Auto-generated documentation || Help:Agent
|-
| <code>Property:{Topic} {prop}</code> || One per property || Property:Agent name
|-
| <code>List of {PluralName}</code> || Overview/listing page || List of Agents
|}

== Contexts at BITPlan ==

Contexts are managed on [https://contexts.bitplan.com contexts.bitplan.com]. Key contexts include:

{| class="wikitable"
! Context !! Description !! Topics
|-
| [https://contexts.bitplan.com/index.php/AgentContext AgentContext] || AI Agent definitions || Agent
|-
| [https://contexts.bitplan.com/index.php/MetaModel MetaModel] || The meta-model itself || Context, Topic, Property, ...
|}

== See Also ==
* [https://wiki.bitplan.com/index.php/Y-Principle Y-Principle] - The underlying design principle
* [https://wiki.bitplan.com/index.php/py-yprinciple-gen py-yprinciple-gen on wiki.bitplan.com] - Technical documentation
* [https://www.semantic-mediawiki.org/wiki/Semantic_MediaWiki Semantic MediaWiki] - The wiki platform

Ypgen - Revision history

Sysop: pushed from media by wikipush