Merge pull request #1 from m7medVision/fix-module-path

Fix module path

Author: m7medVision

.github/workflows/release.yml

@@ -0,0 +1,21 @@
+name: Release
+on:
+  push:
+    branches: [main]
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # required — needs full git history
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - run: npm install -g semantic-release @semantic-release/changelog @semantic-release/git
+      - run: npx semantic-release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.releaserc.json

@@ -0,0 +1,9 @@
+{
+  "branches": ["main"],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    "@semantic-release/git"
+  ]
+}

CHANGELOG.md

@@ -0,0 +1,6 @@
+# 1.0.0 (2026-04-02)
+
+
+### Features
+
+* my new init for next vibecoded application ([d97b2a3](https://github.com/m7medVision/wpswag/commit/d97b2a3a572280686e3dd83bf1b4818042c6b4df))

README.md

@@ -0,0 +1,33 @@
+# wpswag
+
+`wpswag` converts a WordPress REST API into an OpenAPI 3.0.3 JSON file.
+
+## Install
+
+```bash
+go install github.com/m7medVision/wpswag@latest
+```
+
+## Build
+
+```bash
+go build -o wpswag .
+```
+
+## Usage
+
+```bash
+./wpswag convert -u "https://example.com/wp-json" -o openapi.json
+```
+
+You can also run it without building:
+
+```bash
+go run . convert -u "https://example.com/wp-json"
+```
+
+## Notes
+
+- Input can be a WordPress REST URL or a local JSON file.
+- Output defaults to `openapi.json`.
+- The generated spec includes typed schemas for core `wp/v2` resources when schema metadata is available.

cmd/convert.go

@@ -0,0 +1,75 @@
+package cmd
+
+import (
+	"bytes"
+	"encoding/json"
+	"fmt"
+	"os"
+	"path/filepath"
+	"strconv"
+
+	"github.com/spf13/cobra"
+
+	"github.com/m7medVision/wpswag/internal/convert"
+	"github.com/m7medVision/wpswag/internal/util"
+	"github.com/m7medVision/wpswag/internal/wp"
+)
+
+var (
+	flagURL   string
+	flagOut   string
+	flagDebug bool
+)
+
+var convertCmd = &cobra.Command{
+	Use:   "convert",
+	Short: "Convert WordPress REST API JSON to OpenAPI 3.0 spec",
+	Long:  "Fetch a WordPress REST API index (URL or local file) and generate an OpenAPI 3.0.3 JSON specification.",
+	RunE:  runConvert,
+}
+
+func init() {
+	convertCmd.Flags().StringVarP(&flagURL, "url", "u", "", "WordPress REST URL or local JSON file (e.g. https://site/wp-json or ./wp-json.json)")
+	convertCmd.Flags().StringVarP(&flagOut, "output", "o", "openapi.json", "Output OpenAPI file (default: openapi.json)")
+	convertCmd.Flags().BoolVar(&flagDebug, "debug", false, "Print debug stats to stderr")
+	_ = convertCmd.MarkFlagRequired("url")
+	rootCmd.AddCommand(convertCmd)
+}
+
+func runConvert(cmd *cobra.Command, args []string) error {
+	data, err := util.Fetch(flagURL)
+	if err != nil {
+		return fmt.Errorf("fetch error: %w", err)
+	}
+	data = util.CleanJSON(data)
+
+	var idx wp.Index
+	dec := json.NewDecoder(bytes.NewReader(data))
+	dec.UseNumber()
+	if err := dec.Decode(&idx); err != nil {
+		return fmt.Errorf("decode error: %w", err)
+	}
+
+	conv := convert.NewConverter(&idx, flagURL)
+	spec, stats, err := conv.Convert()
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "convert error: %v\n", err)
+	}
+
+	if flagDebug {
+		fmt.Fprintf(os.Stderr, "routes=%d endpoints=%d ops=%d paths_out=%d\n",
+			stats.Routes, stats.Endpoints, stats.Ops, len(spec.Paths))
+	}
+
+	out, err := json.MarshalIndent(spec, "", "  ")
+	if err != nil {
+		return fmt.Errorf("marshal error: %w", err)
+	}
+
+	if err := os.WriteFile(flagOut, out, 0644); err != nil {
+		return fmt.Errorf("write error: %w", err)
+	}
+
+	fmt.Fprintf(os.Stderr, "wrote %s (%s bytes)\n", filepath.Base(flagOut), strconv.Itoa(len(out)))
+	return nil
+}

cmd/root.go

@@ -0,0 +1,22 @@
+package cmd
+
+import (
+	"fmt"
+	"os"
+
+	"github.com/spf13/cobra"
+)
+
+var rootCmd = &cobra.Command{
+	Use:   "wpswag",
+	Short: "Generate OpenAPI 3.0 specs from WordPress REST APIs",
+	Long:  "wpswag converts a WordPress REST API index or namespace JSON into an OpenAPI 3.0.3 specification.",
+}
+
+// Execute runs the root command.
+func Execute() {
+	if err := rootCmd.Execute(); err != nil {
+		fmt.Fprintln(os.Stderr, err)
+		os.Exit(1)
+	}
+}

go.mod

@@ -1,3 +1,10 @@
-module sensepost.com/wpswag
+module github.com/m7medVision/wpswag
 
 go 1.25.1
+
+require github.com/spf13/cobra v1.10.2
+
+require (
+	github.com/inconshreveable/mousetrap v1.1.0 // indirect
+	github.com/spf13/pflag v1.0.9 // indirect
+)

go.sum

@@ -0,0 +1,10 @@
+github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
+github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
+github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
+github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
+github.com/spf13/cobra v1.10.2 h1:DMTTonx5m65Ic0GOoRY2c16WCbHxOOw6xxezuLaBpcU=
+github.com/spf13/cobra v1.10.2/go.mod h1:7C1pvHqHw5A4vrJfjNwvOdzYu0Gml16OCs2GRiTUUS4=
+github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
+github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+go.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=

internal/convert/builder.go

@@ -0,0 +1,112 @@
+package convert
+
+import (
+	"strings"
+
+	"github.com/m7medVision/wpswag/internal/oas"
+)
+
+// Builder incrementally builds an OpenAPI 3.0.3 spec from WordPress routes.
+type Builder struct {
+	spec  *oas.Spec
+	stats Stats
+}
+
+// Stats holds conversion statistics.
+type Stats struct {
+	Routes    int
+	Endpoints int
+	Ops       int
+}
+
+// NewBuilder creates a new spec builder with the given metadata.
+func NewBuilder(title, description, serverURL string) *Builder {
+	if title == "" {
+		title = "WordPress REST"
+	}
+	if serverURL == "" {
+		serverURL = "https://example.com/wp-json"
+	}
+	return &Builder{
+		spec: &oas.Spec{
+			OpenAPI: "3.0.3",
+			Info: oas.Info{
+				Title:       title,
+				Description: description,
+				Version:     "1.0.0",
+			},
+			Servers: []oas.Server{{URL: serverURL}},
+			Paths:   map[string]oas.PathItem{},
+		},
+	}
+}
+
+// AddPath sets a path item on the spec.
+func (b *Builder) AddPath(path string, item oas.PathItem) {
+	b.spec.Paths[path] = item
+}
+
+// GetPath returns the current path item for a given path.
+func (b *Builder) GetPath(path string) oas.PathItem {
+	return b.spec.Paths[path]
+}
+
+// AddSchema stores a reusable schema component on the spec.
+func (b *Builder) AddSchema(name string, schema oas.Schema) {
+	if b.spec.Components == nil {
+		b.spec.Components = &oas.Components{Schemas: map[string]oas.Schema{}}
+	}
+	if b.spec.Components.Schemas == nil {
+		b.spec.Components.Schemas = map[string]oas.Schema{}
+	}
+	if _, exists := b.spec.Components.Schemas[name]; exists {
+		return
+	}
+	b.spec.Components.Schemas[name] = schema
+}
+
+// IncrementRoutes increments the route counter.
+func (b *Builder) IncrementRoutes() {
+	b.stats.Routes++
+}
+
+// IncrementEndpoints increments the endpoint counter.
+func (b *Builder) IncrementEndpoints() {
+	b.stats.Endpoints++
+}
+
+// IncrementOps increments the operations counter.
+func (b *Builder) IncrementOps() {
+	b.stats.Ops++
+}
+
+// SetMethodOperation sets an operation on a path item by HTTP method.
+func SetMethodOperation(pi *oas.PathItem, method string, op *oas.Operation) {
+	switch strings.ToUpper(method) {
+	case "GET":
+		pi.Get = op
+	case "POST":
+		pi.Post = op
+	case "PUT":
+		pi.Put = op
+	case "PATCH":
+		pi.Patch = op
+	case "DELETE":
+		pi.Delete = op
+	case "OPTIONS":
+		pi.Options = op
+	case "HEAD":
+		pi.Head = op
+	}
+}
+
+// IsPathItemEmpty returns true if the path item has no operations.
+func IsPathItemEmpty(pi oas.PathItem) bool {
+	return pi.Get == nil && pi.Post == nil && pi.Put == nil &&
+		pi.Patch == nil && pi.Delete == nil && pi.Options == nil && pi.Head == nil
+}
+
+// Build returns the final spec and stats.
+func (b *Builder) Build() (*oas.Spec, *Stats) {
+	return b.spec, &b.stats
+}