@entropicwarrior/sdoc 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Irreversible Inc.
+
+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,110 @@
+# SDOC
+
+A plain-text documentation format designed for AI-agent efficiency. Explicit brace scoping means deterministic parsing, surgical section extraction, and 10-50x token savings compared to Markdown.
+
+## Why SDOC?
+
+- **Unambiguous structure** — `{ }` braces define scope, not whitespace or heading levels. No guessing where a section ends.
+- **Progressive disclosure** — AI agents can read a table of contents, then extract only the sections they need. No need to consume the whole file.
+- **Unlimited nesting** — Nest scopes as deep as you like. Structure follows your content, not format limitations.
+- **Content-presentation separation** — The AST is format-neutral. Render to HTML, slides, PDF, or anything else from the same source.
+- **Human-readable as plain text** — No build step required to read an SDOC file. It looks good in any text editor.
+
+## What's in the Box
+
+**The format** — a formal specification (`lexica/specification.sdoc`) with EBNF grammar, plus a comprehensive authoring guide written as an AI agent skill document. Drop `lexica/sdoc-authoring.sdoc` into any AI agent's context and it can read and write SDOC immediately.
+
+**A zero-dependency JavaScript parser** — `src/sdoc.js` parses SDOC into a format-neutral AST. No runtime dependencies, works anywhere Node runs. Parsing and rendering are cleanly separated — build your own renderers on top.
+
+**Slide deck generation** — turn any SDOC file into an HTML slide deck with themes, layouts (center, two-column), speaker notes, mermaid diagrams, and PDF export via headless Chrome.
+
+**A document site builder** — serve a folder of SDOC files as a browsable site with sidebar navigation, search, and split-pane comparison.
+
+**A VS Code extension** — live preview, sticky scroll, code folding, document symbols, mermaid rendering, and commands for all the above.
+
+## Quick Start
+
+```bash
+# Build and install the VS Code extension
+npm install
+npm run package
+code --install-extension dist/sdoc-*.vsix
+```
+
+Open any `.sdoc` file and click the preview icon in the editor title bar, or run **SDOC: Open Preview to the Side** from the Command Palette.
+
+### Build slides
+
+```bash
+node tools/build-slides.js deck.sdoc -o slides.html
+```
+
+Each top-level scope becomes a slide. Set `type: slides` in `@meta`. See `lexica/slide-authoring.sdoc` for the full authoring guide.
+
+### Browse documents
+
+```bash
+python3 tools/serve_docs.py docs/
+```
+
+Or use the **SDOC: Browse Documents** command from the VS Code Command Palette.
+
+## Format at a Glance
+
+```sdoc
+# Chapter One @chapter-1
+{
+    This is body text with *emphasis*, **strong**, and `code`.
+
+    # Nested Section @details
+    {
+        Unlimited nesting. Each scope is independently addressable.
+
+        {[code lang=python]
+            def hello():
+                print("Hello from SDOC")
+        }
+    }
+
+    # A List
+    {
+        {[.]
+            - First item
+            - Second item with **bold**
+            - Third item
+        }
+    }
+}
+```
+
+## Learning the Format
+
+- `docs/guide/intro.sdoc` — what SDOC is and why
+- `docs/tutorials/first-steps.sdoc` — write your first document
+- `docs/reference/syntax.sdoc` — full syntax reference
+- `SDOC_GUIDE.md` — quick reference in Markdown (also used by AI tools)
+
+## Contributing
+
+This project uses **Git Flow**:
+
+| Branch | Purpose |
+|---|---|
+| `main` | Stable releases, tagged with version numbers |
+| `develop` | Integration branch — features merge here |
+| `release/vX.Y.Z` | Cut from `develop` when ready to release |
+| `feat/*`, `fix/*` | Short-lived branches off `develop` |
+
+**To contribute:**
+
+1. Create a branch off `develop` (`feat/my-feature`, `fix/parser-bug`, etc.)
+2. Make your changes, commit, push
+3. Open a PR targeting `develop`
+4. Get one approval from another contributor
+5. Merge (squash or regular — your call)
+
+Release branches merge to both `main` and `develop`. No direct pushes to `main` or `develop`.
+
+## License
+
+[MIT](LICENSE) — 2026 Irreversible Inc.

package/index.js

@@ -0,0 +1,2 @@
+module.exports = require("./src/sdoc");
+module.exports.notion = require("./src/notion-renderer");

package/package.json

@@ -0,0 +1,165 @@
+{
+  "name": "@entropicwarrior/sdoc",
+  "displayName": "SDOC",
+  "description": "A plain-text documentation format with explicit brace scoping — deterministic parsing, AI-agent efficiency, and 10-50x token savings vs Markdown.",
+  "version": "0.1.3",
+  "publisher": "entropicwarrior",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/entropicwarrior/sdoc"
+  },
+  "homepage": "https://github.com/entropicwarrior/sdoc",
+  "bugs": {
+    "url": "https://github.com/entropicwarrior/sdoc/issues"
+  },
+  "keywords": [
+    "sdoc",
+    "documentation",
+    "plain-text",
+    "slides",
+    "preview",
+    "ai-agent"
+  ],
+  "exports": {
+    ".": "./index.js",
+    "./notion": "./src/notion-renderer.js"
+  },
+  "engines": {
+    "vscode": "^1.95.0"
+  },
+  "categories": [
+    "Other"
+  ],
+  "activationEvents": [
+    "onLanguage:sdoc",
+    "onCommand:sdoc.preview",
+    "onCommand:sdoc.previewToSide",
+    "onCommand:sdoc.exportHtml",
+    "onCommand:sdoc.openInBrowser",
+    "onCommand:sdoc.browseDocs",
+    "onCommand:sdoc.newKnowledgeFile",
+    "onCommand:sdoc.generateAbout",
+    "onCommand:sdoc.previewFromExplorer"
+  ],
+  "scripts": {
+    "package": "npx vsce package --out dist/"
+  },
+  "main": "./src/extension.js",
+  "contributes": {
+    "languages": [
+      {
+        "id": "sdoc",
+        "aliases": [
+          "SDOC"
+        ],
+        "extensions": [
+          ".sdoc"
+        ],
+        "configuration": "./language-configuration.json"
+      }
+    ],
+    "grammars": [
+      {
+        "language": "sdoc",
+        "scopeName": "source.sdoc",
+        "path": "./syntaxes/sdoc.tmLanguage.json"
+      }
+    ],
+    "commands": [
+      {
+        "command": "sdoc.preview",
+        "title": "SDOC: Open Preview"
+      },
+      {
+        "command": "sdoc.previewToSide",
+        "title": "SDOC: Open Preview to the Side",
+        "icon": "$(open-preview)"
+      },
+      {
+        "command": "sdoc.exportHtml",
+        "title": "SDOC: Export HTML",
+        "icon": "$(desktop-download)"
+      },
+      {
+        "command": "sdoc.openInBrowser",
+        "title": "SDOC: Open in Browser",
+        "icon": "$(link-external)"
+      },
+      {
+        "command": "sdoc.browseDocs",
+        "title": "SDOC: Browse Documents"
+      },
+      {
+        "command": "sdoc.newKnowledgeFile",
+        "title": "SDOC: New Knowledge File"
+      },
+      {
+        "command": "sdoc.generateAbout",
+        "title": "SDOC: Generate About"
+      },
+      {
+        "command": "sdoc.previewFromExplorer",
+        "title": "Open SDOC Preview",
+        "icon": "$(open-preview)"
+      }
+    ],
+    "configurationDefaults": {
+      "[sdoc]": {
+        "editor.wordWrap": "on"
+      }
+    },
+    "languageModelTools": [
+      {
+        "name": "sdoc_reference",
+        "tags": [
+          "sdoc",
+          "documentation"
+        ],
+        "toolReferenceName": "sdoc",
+        "displayName": "SDOC Reference",
+        "modelDescription": "Returns the SDOC format reference guide. Use this tool when you need to create, edit, or understand .sdoc files. SDOC is a plain text documentation format with explicit brace scoping, headings with #, inline formatting like Markdown, and features like braceless scopes, implicit root, lists, tables, code blocks, and meta scopes.",
+        "userDescription": "Get the SDOC format reference guide for creating and editing .sdoc files.",
+        "canBeReferencedInPrompt": true,
+        "icon": "$(book)",
+        "inputSchema": {
+          "type": "object",
+          "properties": {}
+        }
+      }
+    ],
+    "menus": {
+      "editor/title": [
+        {
+          "command": "sdoc.previewToSide",
+          "when": "editorLangId == sdoc",
+          "group": "navigation"
+        },
+        {
+          "command": "sdoc.exportHtml",
+          "when": "activeWebviewPanelId == 'sdoc.preview'",
+          "group": "navigation"
+        },
+        {
+          "command": "sdoc.openInBrowser",
+          "when": "activeWebviewPanelId == 'sdoc.preview'",
+          "group": "navigation"
+        }
+      ],
+      "explorer/context": [
+        {
+          "command": "sdoc.previewFromExplorer",
+          "when": "resourceExtname == .sdoc",
+          "group": "navigation"
+        },
+        {
+          "command": "sdoc.newKnowledgeFile",
+          "group": "navigation"
+        }
+      ]
+    }
+  },
+  "devDependencies": {
+    "@vscode/vsce": "^3.7.1"
+  }
+}