kitfly 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to Kitfly are documented here.
+
+## [0.1.2] - 2026-02-10
+
+### Added
+
+- Configurable sidebar width via `theme.yaml` `layout.sidebarWidth` (default `280px`)
+- Site version in footer provenance: reads from `site.yaml` `version` field, falls back to git tag
+- Schema support for `version` field in `site.schema.json`
+- Schema support for `layout.sidebarWidth` in `theme.schema.json`
+- Comprehensive test coverage: 466 → 1174 tests, 56.9% → 68.7% statements, 42.3% → 79.6% functions
+- Template test suites: crucible, pipeline, productbook, runbook, servicebook (all 100% coverage)
+- Bundle test suite: parseArgs, imageMime, rewriteContentLinks, fileToDataUri, inlineLocalImages
+
+### Fixed
+
+- Footer provenance now displays site version instead of kitfly engine version
+- Sidebar folder indicators: replaced tiny `▸`/`▾` triangles with `›` chevron + 150ms rotation transition
+- Test suite: removed fs mocks from theme tests (eliminated cross-file mock contamination)
+- Test suite: fixed Bun/Node dual-runtime compatibility for coverage runs
+- Lint: eliminated 541 non-null assertion warnings across test files
+
+## [0.1.1] - 2026-02-10
+
+### Added
+
+- Three-zone footer layout with configurable copyright, links, and attribution
+- `footer.copyright` — override auto-generated copyright text
+- `footer.copyrightUrl` — make copyright text a clickable link
+- `footer.links` — custom footer links (max 10); empty array suppresses all center links
+- `footer.attribution` — toggle "Built with Kitfly" (default: true)
+- Immutable `KitflyBrand` constant — tool identity separate from user's `SiteBrand`
+- Bundle footer parity via shared `buildBundleFooter()`
+- HTML escaping for all user-provided config strings in footer output
+- Platform binary releases: Linux x64/arm64, macOS arm64, Windows x64/arm64
+- Provenance label: `Published YYYY-MM-DD` (was bare date)
+- Copyright year derived from publish date, not runtime
+
+### Fixed
+
+- `brand.url: "/"` (relative URL) now displays `brand.name` as footer link text
+- Footer wrapping on narrow viewports: `min-height` replaces fixed `height`
+
+## [0.1.0] - 2026-02-05
+
+### Added
+
+- Initial release
+- `kitfly init` — scaffold documentation sites (minimal, handbook templates)
+- `kitfly dev` — development server with hot reload
+- `kitfly build` — static site generation
+- `kitfly bundle` — single-file HTML output
+- Auto-discovered navigation from folder structure
+- Brand logo/favicon support with bounded responsive slot
+- Dark mode with system preference detection
+- YAML-based config with JSON schema validation
+- Cross-platform CI: Linux x64/arm64, macOS arm64, Windows x64/arm64
+- Dual-format release signing: minisign + GPG

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 3 Leaps LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,136 @@
+<p align="center">
+  <img src="assets/brand/kitfly-logo-512.png" alt="Kitfly" width="180">
+</p>
+
+<h1 align="center">Kitfly</h1>
+
+<p align="center"><strong>Turn your writing into a website.</strong></p>
+
+<p align="center">~500 lines of code. One dependency. Zero config required.</p>
+
+<p align="center">No SaaS subscriptions. No 500MB node_modules. Just your docs, rendered clean.</p>
+
+---
+
+## Three Ways to Use Kitfly
+
+| Approach | Best For | What You Get |
+|----------|----------|--------------|
+| **`kitfly init`** | New projects | Standalone site with your own copy of the code |
+| **`kitfly dev ./folder`** | Existing docs | Quick preview without changing anything |
+| **Clone this repo** | Contributors | The kitfly engine itself |
+
+### Create a Standalone Site (Recommended)
+
+```bash
+kitfly init my-docs
+cd my-docs
+bun install
+bun run dev
+```
+
+You get a complete, self-contained site: rendering code, template, styles, config. It's yours — modify it, version it, own it. No kitfly CLI required after setup.
+
+### Preview Existing Docs
+
+```bash
+kitfly dev ./path/to/markdown
+kitfly build ./docs --out ./dist
+kitfly bundle ./docs --name docs.html
+```
+
+Render any folder of markdown instantly. Great for docs that live in another repo.
+
+### Clone for Development
+
+```bash
+git clone https://github.com/3leaps/kitfly
+cd kitfly
+bun install
+bun run dev
+```
+
+The `content/` folder is the actual kitfly documentation. What you see is what you get.
+
+See [Kitfly Overview](content/guide/kitfly-overview.md) for the full picture.
+
+---
+
+## Two Ways to Share
+
+**Send it** — Single HTML file you can email, Slack, or drop in a shared drive. Works offline.
+
+**Host it** — Static site you deploy to GitHub Pages, Netlify, S3, anywhere.
+
+---
+
+## What You Get
+
+| Feature | How |
+|---------|-----|
+| Hot reload | Edit markdown, see changes instantly |
+| Navigation | Auto-generated from folder structure |
+| Table of contents | Extracted from headings |
+| Dark mode | System preference + toggle |
+| Diagrams | Mermaid via CDN |
+| Syntax highlighting | Prism.js via CDN |
+| Offline-ready | Static HTML, no server required |
+
+## What You Don't Get
+
+- Component libraries
+- Client-side routing
+- Build pipelines to learn
+- Framework lock-in
+- Subscription fees
+
+If you need those features, use [Astro](https://astro.build), [VitePress](https://vitepress.dev), or [Docusaurus](https://docusaurus.io). They're excellent. Kitfly is for when you don't.
+
+---
+
+## Configuration
+
+Create `site.yaml` (optional):
+
+```yaml
+docroot: "content"
+title: "My Documentation"
+home: "index.md"
+
+brand:
+  name: "My Project"
+  url: "/"
+
+sections:
+  - name: "Guide"
+    path: "guide"
+  - name: "Reference"
+    path: "reference"
+```
+
+Or just drop markdown files in `content/` — sections auto-discover.
+
+---
+
+## Philosophy
+
+> **Rule of thumb**: If it can't be done with CSS, vanilla JS under 50 lines, or a marked plugin, it doesn't belong here.
+
+Kitfly is intentionally limited. The goal is a doc site that stays simple and maintainable. When you outgrow it, migrate — your content is just markdown.
+
+---
+
+## Name
+
+**Kit** + **Fly**
+
+- **Kit**: Your handbook, runbook, notebook — a collection of docs
+- **Fly**: Fast, instant, launching to the web
+
+*Pack your docs. Watch them fly.*
+
+---
+
+**License:** MIT
+
+Made by [3 Leaps](https://3leaps.net)

package/VERSION

@@ -0,0 +1 @@
+0.1.2

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "kitfly",
+  "version": "0.1.2",
+  "type": "module",
+  "description": "Turn your writing into a website",
+  "bin": {
+    "kitfly": "./src/cli.ts"
+  },
+  "files": [
+    "src/",
+    "scripts/",
+    "schemas/",
+    "dist/",
+    "!dist/release/",
+    "VERSION",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "dev": "bun run scripts/dev.ts",
+    "build": "bun run scripts/build.ts",
+    "bundle": "bun run scripts/bundle.ts",
+    "cli": "bun run src/cli.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "biome check src/ scripts/",
+    "lint:ci": "biome check --no-errors-on-unmatched src/ scripts/",
+    "fmt": "biome check --write src/ scripts/",
+    "format:check": "biome check --no-errors-on-unmatched src/ scripts/",
+    "typecheck": "tsc --noEmit",
+    "build:all": "bun scripts/build-all.ts",
+    "build:local": "bun build src/cli.ts --compile --outfile dist/kitfly",
+    "version:sync": "bun run scripts/version-sync.ts",
+    "version:check": "bun run scripts/version-sync.ts --check"
+  },
+  "dependencies": {
+    "@3leaps/sysprims": "^0.1.12",
+    "@fulmenhq/tsfulmen": "^0.2.7",
+    "marked": "^15.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.2.5",
+    "@types/bun": "^1.2.0",
+    "@vitest/coverage-v8": "^4.0.18",
+    "prettier": "^3.6.2",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.18"
+  },
+  "author": "3 Leaps <hello@3leaps.net>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/3leaps/kitfly"
+  },
+  "keywords": [
+    "documentation",
+    "markdown",
+    "static-site",
+    "docs"
+  ]
+}

package/schemas/README.md

@@ -0,0 +1,32 @@
+---
+title: "Kitfly Schemas"
+description: "Schema versioning policy for site.yaml and theme.yaml"
+last_updated: "2026-02-05"
+---
+
+# Schemas
+
+Kitfly ships JSON Schemas for editor validation and migration detection.
+
+## Versioned Folders
+
+Schemas live under versioned folders:
+
+- `schemas/v0/` - alpha schemas (Kitfly v0.x.x)
+- `schemas/v1/` - stable schemas (when Kitfly reaches v1.x.x)
+
+The `v0/` folder name indicates the maturity track, not the exact schema content version.
+
+## Embedded Version
+
+Each schema includes:
+
+- `$id` - canonical identity (absolute URI)
+- `$version` - schema content version (semver string)
+
+Standalone sites are detached copies, so schemas must be self-describing.
+
+## Backward Compatibility
+
+For convenience, `schemas/site.schema.json` and `schemas/theme.schema.json` remain as thin wrappers
+that `$ref` the latest `schemas/v0/*` schemas.

package/schemas/site.schema.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kitfly.app/schemas/site.schema.json",
+  "$ref": "./v0/site.schema.json"
+}

package/schemas/theme.schema.json

@@ -0,0 +1,5 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kitfly.app/schemas/theme.schema.json",
+  "$ref": "./v0/theme.schema.json"
+}

package/schemas/v0/site.schema.json

@@ -0,0 +1,172 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://kitfly.app/schemas/v0/site.schema.json",
+  "$version": "0.1.0",
+  "title": "Site Configuration",
+  "description": "Configuration for Kitfly static site generator",
+  "type": "object",
+  "required": ["title", "brand", "sections"],
+  "properties": {
+    "schemaVersion": {
+      "type": "string",
+      "description": "Schema version this config targets (for migration detection)",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$",
+      "default": "0.1.0"
+    },
+    "docroot": {
+      "type": "string",
+      "description": "Root directory for content (relative to repo root)",
+      "default": "."
+    },
+    "title": {
+      "type": "string",
+      "description": "Site title shown in browser tab and header",
+      "maxLength": 60
+    },
+    "version": {
+      "type": "string",
+      "description": "Site version displayed in footer provenance",
+      "examples": ["1.0.0", "2024.03", "draft"]
+    },
+    "home": {
+      "type": "string",
+      "description": "Home page file (rendered as index.html, not in nav)"
+    },
+    "brand": {
+      "type": "object",
+      "description": "Brand configuration for logo and links",
+      "required": ["name", "url"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Brand name shown in sidebar",
+          "maxLength": 30
+        },
+        "url": {
+          "type": "string",
+          "description": "URL for brand logo link"
+        },
+        "external": {
+          "type": "boolean",
+          "description": "Open brand link in new tab (target=_blank)",
+          "default": false
+        },
+        "logo": {
+          "type": "string",
+          "description": "Path to logo image (relative to site root)",
+          "default": "assets/brand/logo.png"
+        },
+        "favicon": {
+          "type": "string",
+          "description": "Path to favicon image (relative to site root)",
+          "default": "assets/brand/favicon.png"
+        },
+        "logoType": {
+          "type": "string",
+          "description": "Logo type: icon (square) or wordmark (wide)",
+          "enum": ["icon", "wordmark"],
+          "default": "icon"
+        }
+      },
+      "additionalProperties": false
+    },
+    "sections": {
+      "type": "array",
+      "description": "Navigation sections and their content sources",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["name", "path"],
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Section name shown in navigation",
+            "maxLength": 20
+          },
+          "path": {
+            "type": "string",
+            "description": "Directory path relative to docroot"
+          },
+          "files": {
+            "type": "array",
+            "description": "Specific files to include (for root-level sections)",
+            "items": { "type": "string" }
+          },
+          "maxDepth": {
+            "type": "integer",
+            "description": "Maximum directory depth for auto-discovery",
+            "minimum": 0,
+            "maximum": 10,
+            "default": 4
+          },
+          "exclude": {
+            "type": "array",
+            "description": "Glob patterns to exclude from auto-discovery",
+            "items": { "type": "string" }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "footer": {
+      "type": "object",
+      "description": "Footer configuration for copyright, links, and attribution",
+      "properties": {
+        "copyright": {
+          "type": "string",
+          "description": "Override footer copyright text"
+        },
+        "copyrightUrl": {
+          "type": "string",
+          "description": "Make copyright text a clickable link to this URL"
+        },
+        "links": {
+          "type": "array",
+          "description": "Custom footer links (replaces default brand URL link)",
+          "maxItems": 10,
+          "items": {
+            "type": "object",
+            "required": ["text", "url"],
+            "properties": {
+              "text": {
+                "type": "string",
+                "description": "Footer link label"
+              },
+              "url": {
+                "type": "string",
+                "description": "Footer link destination URL"
+              }
+            },
+            "additionalProperties": false
+          }
+        },
+        "attribution": {
+          "type": "boolean",
+          "description": "Show Built with Kitfly attribution",
+          "default": true
+        }
+      },
+      "additionalProperties": false
+    },
+    "server": {
+      "type": "object",
+      "description": "Development server configuration",
+      "properties": {
+        "port": {
+          "type": "integer",
+          "description": "Default port for dev server",
+          "minimum": 1,
+          "maximum": 65535,
+          "default": 3333
+        },
+        "host": {
+          "type": "string",
+          "description": "Default host for dev server",
+          "default": "localhost"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}