onetool-mcp 1.0.0b1__py3-none-any.whl → 1.0.0rc2__py3-none-any.whl

ot/config/{defaults → global_templates}/diagram-templates/microservices.d2

@@ -1,81 +1,81 @@
-# Microservices Architecture Template
-# Replace placeholders with actual service names
-
-direction: right
-
-# External actors
-user: "User" {
-  shape: person
-}
-
-# Frontend layer
-frontend: "Frontend" {
-  style.fill: "#e3f2fd"
-
-  web: "Web App"
-  mobile: "Mobile App"
-}
-
-# API layer
-gateway: "API Gateway" {
-  style.fill: "#fff3e0"
-
-  auth: "Auth"
-  routing: "Router"
-  rate_limit: "Rate Limiter"
-}
-
-# Services layer
-services: "Services" {
-  style.fill: "#e8f5e9"
-
-  user_svc: "User Service"
-  order_svc: "Order Service"
-  notification_svc: "Notification Service"
-}
-
-# Data layer
-data: "Data Stores" {
-  style.fill: "#fce4ec"
-
-  postgres: "PostgreSQL" {
-    shape: cylinder
-  }
-  redis: "Redis" {
-    shape: cylinder
-  }
-  queue: "Message Queue" {
-    shape: queue
-  }
-}
-
-# External services
-external: "External" {
-  style.stroke-dash: 3
-
-  email: "Email Provider"
-  payment: "Payment Gateway"
-}
-
-# Connections
-user -> frontend.web
-user -> frontend.mobile
-
-frontend.web -> gateway.routing
-frontend.mobile -> gateway.routing
-
-gateway.routing -> gateway.auth
-gateway.auth -> services.user_svc
-gateway.routing -> services.order_svc
-gateway.routing -> services.notification_svc
-
-services.user_svc -> data.postgres
-services.order_svc -> data.postgres
-services.order_svc -> data.queue
-
-services.notification_svc -> data.queue
-services.notification_svc -> external.email
-
-services.order_svc -> external.payment
-
-data.redis <- gateway.rate_limit: "Rate limits"
+# Microservices Architecture Template
+# Replace placeholders with actual service names
+
+direction: right
+
+# External actors
+user: "User" {
+  shape: person
+}
+
+# Frontend layer
+frontend: "Frontend" {
+  style.fill: "#e3f2fd"
+
+  web: "Web App"
+  mobile: "Mobile App"
+}
+
+# API layer
+gateway: "API Gateway" {
+  style.fill: "#fff3e0"
+
+  auth: "Auth"
+  routing: "Router"
+  rate_limit: "Rate Limiter"
+}
+
+# Services layer
+services: "Services" {
+  style.fill: "#e8f5e9"
+
+  user_svc: "User Service"
+  order_svc: "Order Service"
+  notification_svc: "Notification Service"
+}
+
+# Data layer
+data: "Data Stores" {
+  style.fill: "#fce4ec"
+
+  postgres: "PostgreSQL" {
+    shape: cylinder
+  }
+  redis: "Redis" {
+    shape: cylinder
+  }
+  queue: "Message Queue" {
+    shape: queue
+  }
+}
+
+# External services
+external: "External" {
+  style.stroke-dash: 3
+
+  email: "Email Provider"
+  payment: "Payment Gateway"
+}
+
+# Connections
+user -> frontend.web
+user -> frontend.mobile
+
+frontend.web -> gateway.routing
+frontend.mobile -> gateway.routing
+
+gateway.routing -> gateway.auth
+gateway.auth -> services.user_svc
+gateway.routing -> services.order_svc
+gateway.routing -> services.notification_svc
+
+services.user_svc -> data.postgres
+services.order_svc -> data.postgres
+services.order_svc -> data.queue
+
+services.notification_svc -> data.queue
+services.notification_svc -> external.email
+
+services.order_svc -> external.payment
+
+data.redis <- gateway.rate_limit: "Rate limits"

ot/config/{defaults → global_templates}/diagram-templates/project-gantt.mmd

@@ -1,37 +1,37 @@
-%% Project Gantt Chart Template
-%% Replace with your actual project timeline
-
-gantt
-    title Project Timeline
-    dateFormat YYYY-MM-DD
-    excludes weekends
-
-    section Planning
-    Requirements gathering     :a1, 2024-01-08, 5d
-    Technical design          :a2, after a1, 5d
-    Architecture review       :milestone, m1, after a2, 0d
-
-    section Development
-    Core infrastructure       :b1, after m1, 10d
-    Feature A implementation  :b2, after b1, 8d
-    Feature B implementation  :b3, after b1, 12d
-    Integration               :b4, after b2, 5d
-    Development complete      :milestone, m2, after b4, 0d
-
-    section Testing
-    Unit testing             :c1, after b2, 5d
-    Integration testing      :c2, after m2, 5d
-    Performance testing      :c3, after c2, 3d
-    UAT                      :c4, after c3, 5d
-    Testing complete         :milestone, m3, after c4, 0d
-
-    section Deployment
-    Staging deployment       :d1, after m3, 2d
-    Production preparation   :d2, after d1, 2d
-    Go-live                  :milestone, m4, after d2, 0d
-    Post-launch support      :d3, after m4, 5d
-
-    section Documentation
-    API documentation        :e1, after b1, 15d
-    User guide               :e2, after c2, 10d
-    Release notes            :e3, after m3, 3d
+%% Project Gantt Chart Template
+%% Replace with your actual project timeline
+
+gantt
+    title Project Timeline
+    dateFormat YYYY-MM-DD
+    excludes weekends
+
+    section Planning
+    Requirements gathering     :a1, 2024-01-08, 5d
+    Technical design          :a2, after a1, 5d
+    Architecture review       :milestone, m1, after a2, 0d
+
+    section Development
+    Core infrastructure       :b1, after m1, 10d
+    Feature A implementation  :b2, after b1, 8d
+    Feature B implementation  :b3, after b1, 12d
+    Integration               :b4, after b2, 5d
+    Development complete      :milestone, m2, after b4, 0d
+
+    section Testing
+    Unit testing             :c1, after b2, 5d
+    Integration testing      :c2, after m2, 5d
+    Performance testing      :c3, after c2, 3d
+    UAT                      :c4, after c3, 5d
+    Testing complete         :milestone, m3, after c4, 0d
+
+    section Deployment
+    Staging deployment       :d1, after m3, 2d
+    Production preparation   :d2, after d1, 2d
+    Go-live                  :milestone, m4, after d2, 0d
+    Post-launch support      :d3, after m4, 5d
+
+    section Documentation
+    API documentation        :e1, after b1, 15d
+    User guide               :e2, after c2, 10d
+    Release notes            :e3, after m3, 3d

ot/config/{defaults → global_templates}/diagram-templates/state-machine.mmd

@@ -1,42 +1,42 @@
-%% State Machine Template
-%% Replace states and transitions with your workflow
-
-stateDiagram-v2
-    [*] --> Draft: create
-
-    Draft --> Submitted: submit
-    Draft --> Cancelled: cancel
-
-    Submitted --> UnderReview: assign_reviewer
-    Submitted --> Draft: request_changes
-
-    UnderReview --> Approved: approve
-    UnderReview --> Rejected: reject
-    UnderReview --> Draft: request_changes
-
-    Approved --> Published: publish
-    Approved --> Draft: unpublish
-
-    Rejected --> Draft: revise
-    Rejected --> Cancelled: abandon
-
-    Published --> Archived: archive
-    Published --> Draft: unpublish
-
-    Cancelled --> [*]
-    Archived --> [*]
-
-    note right of Draft
-        Initial state for new items.
-        Can be edited freely.
-    end note
-
-    note right of UnderReview
-        Assigned to a reviewer.
-        Cannot be edited by author.
-    end note
-
-    note right of Published
-        Visible to all users.
-        Audit trail maintained.
-    end note
+%% State Machine Template
+%% Replace states and transitions with your workflow
+
+stateDiagram-v2
+    [*] --> Draft: create
+
+    Draft --> Submitted: submit
+    Draft --> Cancelled: cancel
+
+    Submitted --> UnderReview: assign_reviewer
+    Submitted --> Draft: request_changes
+
+    UnderReview --> Approved: approve
+    UnderReview --> Rejected: reject
+    UnderReview --> Draft: request_changes
+
+    Approved --> Published: publish
+    Approved --> Draft: unpublish
+
+    Rejected --> Draft: revise
+    Rejected --> Cancelled: abandon
+
+    Published --> Archived: archive
+    Published --> Draft: unpublish
+
+    Cancelled --> [*]
+    Archived --> [*]
+
+    note right of Draft
+        Initial state for new items.
+        Can be edited freely.
+    end note
+
+    note right of UnderReview
+        Assigned to a reviewer.
+        Cannot be edited by author.
+    end note
+
+    note right of Published
+        Visible to all users.
+        Audit trail maintained.
+    end note

ot/config/global_templates/diagram.yaml

@@ -0,0 +1,167 @@
+# Diagram tool configuration
+# Provides templates, instructions, and output settings for diagram generation.
+
+tools:
+  diagram:
+    backend:
+      type: kroki
+      remote_url: https://kroki.io
+      self_hosted_url: http://localhost:8000
+      prefer: remote  # remote | self_hosted | auto
+      timeout: 30.0
+
+    policy:
+      rules: |
+        NEVER use ASCII art or text-based diagrams in markdown.
+        Use the diagram tools for all visual representations.
+        Save output as SVG and reference in markdown.
+        Always generate source first, then render.
+        Choose the provider based on diagram type - see instructions.
+      preferred_format: svg
+      preferred_providers:
+        - mermaid
+        - d2
+        - plantuml
+
+    output:
+      dir: ../diagrams  # Relative to .onetool/ directory
+      naming: "{provider}_{name}_{timestamp}"
+      default_format: svg
+      save_source: true
+
+    instructions:
+      mermaid:
+        when_to_use: |
+          - Flowcharts and decision trees
+          - Sequence diagrams for API flows
+          - Class diagrams for data models
+          - State diagrams for workflows
+          - Gantt charts for project timelines
+          - Mindmaps for brainstorming
+        style_tips: |
+          Use subgraphs to group related nodes.
+          Keep flowcharts top-to-bottom (TD) for readability.
+          Limit sequence diagrams to 5-7 participants.
+
+          QUOTING RULES (critical):
+          - Sequence diagrams: NO quotes after 'as' (they appear literally)
+            Use: participant WS as Web Server
+            NOT: participant WS as "Web Server"
+          - Flowcharts/class: USE quotes for labels with spaces
+            Use: A["Start Process"], B{"Decision?"}
+          - Never put spaces in node/participant IDs
+        syntax_guide: https://mermaid.js.org/syntax/
+        example: |
+          sequenceDiagram
+              participant C as Client
+              participant S as Server
+              C->>S: Request
+              S-->>C: Response
+
+      plantuml:
+        when_to_use: |
+          - Complex UML diagrams (class, component, deployment)
+          - C4 architecture diagrams (use stdlib)
+          - Detailed sequence diagrams with notes
+          - Diagrams requiring themes and skinparams
+        style_tips: |
+          Use skinparam for consistent theming.
+          Leverage !include for reusable components.
+          Use packages to organise large diagrams.
+          Add notes for context on complex relationships.
+
+          QUOTING RULES (critical):
+          - Always quote display names BEFORE 'as':
+            participant "Web Server" as WS
+          - Never put spaces in aliases (the ID after 'as')
+          - Use stereotypes for interfaces: <<interface>>
+        syntax_guide: https://plantuml.com/
+        example: |
+          @startuml
+          actor User
+          participant "API Gateway" as GW
+          database DB
+
+          User -> GW: Login request
+          GW -> DB: Check credentials
+          DB --> GW: User record
+          GW --> User: 200 OK
+          @enduml
+
+      d2:
+        when_to_use: |
+          - Clean architecture diagrams
+          - System context diagrams
+          - Hand-drawn style (sketch mode)
+          - Layouts with automatic positioning
+          - C4-style container diagrams
+        style_tips: |
+          Use containers for logical grouping.
+          D2 auto-layouts well - avoid manual positioning.
+          Use markdown in labels for rich formatting.
+          Leverage layers for complex diagrams.
+          Use shape: person for actors.
+          Direction hint: direction: right or direction: down.
+
+          QUOTING RULES (critical):
+          - Always quote labels after colon: node: "Display Name"
+          - IDs (before colon) should not have spaces
+          - Use style.sketch: true for hand-drawn look
+        syntax_guide: https://d2lang.com/tour/intro
+        example: |
+          direction: right
+
+          user: "User" {
+            shape: person
+          }
+
+          system: "My System" {
+            api: "API Server"
+            db: "Database"
+          }
+
+          user -> system.api: "Uses"
+          system.api -> system.db
+
+    templates:
+      api-flow:
+        provider: mermaid
+        diagram_type: sequence
+        description: REST API request/response flow
+        file: config/diagram-templates/api-flow.mmd
+
+      microservices:
+        provider: d2
+        diagram_type: architecture
+        description: Microservices architecture layout
+        file: config/diagram-templates/microservices.d2
+
+      c4-context:
+        provider: plantuml
+        diagram_type: c4
+        description: C4 system context diagram
+        file: config/diagram-templates/c4-context.puml
+
+      state-machine:
+        provider: mermaid
+        diagram_type: state
+        description: State machine diagram
+        file: config/diagram-templates/state-machine.mmd
+
+      class-diagram:
+        provider: mermaid
+        diagram_type: class
+        description: Class/data model diagram
+        file: config/diagram-templates/class-diagram.mmd
+
+      project-gantt:
+        provider: mermaid
+        diagram_type: gantt
+        description: Project timeline Gantt chart
+        file: config/diagram-templates/project-gantt.mmd
+
+      feature-mindmap:
+        provider: mermaid
+        diagram_type: mindmap
+        description: Feature brainstorming mindmap
+        file: config/diagram-templates/feature-mindmap.mmd

ot/config/global_templates/onetool.yaml

@@ -5,10 +5,12 @@
 version: 1
 
 # Include external config files (merged left-to-right)
-# Paths are relative to OT_DIR (~/.onetool/), with fallback to bundled defaults
+# Paths are relative to OT_DIR (~/.onetool/), with fallback to global config
 include:
   - config/snippets.yaml   # Snippet workflows
   - config/servers.yaml    # External MCP servers
+  - config/security.yaml   # Security allowlists (builtins, imports, calls)
+  - config/diagram.yaml    # Diagram tool settings and templates
 
 tools_dir: []