Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions .github/codeql-config.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
# CodeQL config for tknatwork/side-kicks
# https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/customizing-your-advanced-setup-for-code-scanning
#
# Paired with .github/workflows/codeql.yml. The workflow sets
# source-root: variables-styles-extractor so paths below are relative
# to the plugin folder.

name: "Side-Kicks CodeQL config"

paths-ignore:
# Archived prior plugin versions. Already shipped; scanning them on
# every push would surface findings we can't act on without a new
# release of an old version.
- releases
# Pre-rewrite backups of the live source. Not part of the runtime.
- backup
# pnpm install artifacts, just in case CI ever populates them.
- node_modules
- .pnpm-store
79 changes: 0 additions & 79 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,85 +27,6 @@ updates:
dev-dependencies:
dependency-type: "development"

# Design System Builder — pnpm workspace (root lockfile covers all packages)
- package-ecosystem: "npm"
directory: "/Design System Builder"
schedule:
interval: "weekly"
day: "monday"
open-pull-requests-limit: 5
labels:
- "dependencies"
- "npm"
- "design-system-builder"
commit-message:
prefix: "chore(deps)"
include: "scope"
groups:
dev-dependencies:
dependency-type: "development"

# nectar-design-toolkit — each subproject ships its own package-lock.json
- package-ecosystem: "npm"
directory: "/nectar-design-toolkit/bridge-server"
schedule: { interval: "weekly", day: "monday" }
open-pull-requests-limit: 5
labels: ["dependencies", "npm", "nectar-design-toolkit"]
commit-message: { prefix: "chore(deps)", include: "scope" }
groups:
dev-dependencies:
dependency-type: "development"

- package-ecosystem: "npm"
directory: "/nectar-design-toolkit/figma-plugin"
schedule: { interval: "weekly", day: "monday" }
open-pull-requests-limit: 5
labels: ["dependencies", "npm", "nectar-design-toolkit"]
commit-message: { prefix: "chore(deps)", include: "scope" }
groups:
dev-dependencies:
dependency-type: "development"

- package-ecosystem: "npm"
directory: "/nectar-design-toolkit/mcp-server"
schedule: { interval: "weekly", day: "monday" }
open-pull-requests-limit: 5
labels: ["dependencies", "npm", "nectar-design-toolkit"]
commit-message: { prefix: "chore(deps)", include: "scope" }
groups:
dev-dependencies:
dependency-type: "development"

- package-ecosystem: "npm"
directory: "/nectar-design-toolkit/nds-builder"
schedule: { interval: "weekly", day: "monday" }
open-pull-requests-limit: 5
labels: ["dependencies", "npm", "nectar-design-toolkit"]
commit-message: { prefix: "chore(deps)", include: "scope" }
groups:
dev-dependencies:
dependency-type: "development"

- package-ecosystem: "npm"
directory: "/nectar-design-toolkit/nectar-style-generator"
schedule: { interval: "weekly", day: "monday" }
open-pull-requests-limit: 5
labels: ["dependencies", "npm", "nectar-design-toolkit"]
commit-message: { prefix: "chore(deps)", include: "scope" }
groups:
dev-dependencies:
dependency-type: "development"

- package-ecosystem: "npm"
directory: "/nectar-design-toolkit/orchestration-server"
schedule: { interval: "weekly", day: "monday" }
open-pull-requests-limit: 5
labels: ["dependencies", "npm", "nectar-design-toolkit"]
commit-message: { prefix: "chore(deps)", include: "scope" }
groups:
dev-dependencies:
dependency-type: "development"

# ── GitHub Actions ─────────────────────────────────────────────────────────

- package-ecosystem: "github-actions"
Expand Down
9 changes: 9 additions & 0 deletions .github/workflows/codeql.yml
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,15 @@ jobs:
languages: ${{ matrix.language }}
# Use security-extended for stronger ruleset (default is "security")
queries: security-extended
# Root extraction in the plugin folder so docs-only PRs still
# have JS/TS to extract. Without this, CodeQL's diff-informed
# autobuilder sees no source on YAML+MD diffs and exits with
# "no source code seen during build" (exit 32). After the
# 2026-06-06 deletion of Design System Builder/ and
# nectar-design-toolkit/, the plugin folder is the only
# location with JS/TS in the repo.
source-root: variables-styles-extractor
config-file: ./.github/codeql-config.yml

- name: Perform CodeQL Analysis
uses: github/codeql-action/analyze@v3
Expand Down
15 changes: 8 additions & 7 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Updated by: manual + commits referencing structural changes
Pairs with: CLAUDE.md (pointer), docs/AI_CONTEXT.md (legacy folder context, protected),
per-project AGENTS.md (e.g. variables-styles-extractor/AGENTS.md)
Update trigger: structural change (new project, new convention, security policy update)
Last verified: 2026-05-22 (initial Portfolio-style AI structure)
Last verified: 2026-06-06 (after `nectar-design-toolkit/` and `Design System Builder/` deletion)
Index: README.md → table of projects
=== END PAIRING === -->

Expand All @@ -25,8 +25,11 @@ shipping:
| Project | Folder | Status |
|---------|--------|--------|
| Variables & Styles Extractor | [`variables-styles-extractor/`](variables-styles-extractor/) | Published on Figma Community ([1584331992332668732](https://www.figma.com/community/plugin/1584331992332668732/variables-and-styles-extractor)) |
| Nectar Design Toolkit | [`nectar-design-toolkit/`](nectar-design-toolkit/) | Active development |
| Design System Builder | [`Design System Builder/`](Design%20System%20Builder/) | Active development |

> Historical: `nectar-design-toolkit/` and `Design System Builder/` were
> removed on 2026-06-06 (see [`docs/CHANGELOG.md`](docs/CHANGELOG.md)).
> The workspace layout is preserved so future projects can land alongside
> the plugin without restructuring.

---

Expand Down Expand Up @@ -56,9 +59,7 @@ banned without explicit user permission.

| You're editing | You may also touch | You must NOT touch |
|----------------|--------------------|--------------------|
| `variables-styles-extractor/**` | Root `README.md`, `.github/` if it's a security/CI change you've been asked for | Other project folders |
| `nectar-design-toolkit/**` | Same | Other project folders |
| `Design System Builder/**` | Same | Other project folders |
| `variables-styles-extractor/**` | Root `README.md`, `.github/` if it's a security/CI change you've been asked for | Future sibling project folders if/when they land |
| Workspace root files (this file, README, `.gcc/`) | Any project's README if cross-cutting | Per-project source unless explicitly asked |

If a single change genuinely spans two project folders (e.g. extracting
Expand Down Expand Up @@ -184,4 +185,4 @@ Then update this file's "What this repo is" table.

---

*Last updated: 2026-05-22 (initial Portfolio-style structure)*
*Last updated: 2026-06-06 (`nectar-design-toolkit/` and `Design System Builder/` removed; project scope rules collapsed to single-project)*
34 changes: 16 additions & 18 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,8 +13,8 @@ A multi-project workspace for Figma plugins and design tools.
| Project | Folder | Status | Notes |
|---------|--------|--------|-------|
| Variables & Styles Extractor | [`variables-styles-extractor/`](variables-styles-extractor/) | Published v2.0.0 (17 Jan 2026) | Figma plugin · [Community page](https://www.figma.com/community/plugin/1584331992332668732/variables-and-styles-extractor) |
| Nectar Design Toolkit | [`nectar-design-toolkit/`](nectar-design-toolkit/) | Active development | Multi-component design-system suite |
| Design System Builder | [`Design System Builder/`](Design%20System%20Builder/) | Active development | Claude-native Figma design system toolkit |

> The workspace previously hosted `nectar-design-toolkit/` and `Design System Builder/`. Both were removed on 2026-06-06 — see [`docs/CHANGELOG.md`](docs/CHANGELOG.md). The multi-project layout is retained so new projects can land later without restructuring.

---

Expand Down Expand Up @@ -43,21 +43,19 @@ side-kicks/ (this repo: tknatwork/side-kicks
├── docs/
│ ├── AI_CONTEXT.md ← Legacy folder context (PROTECTED)
│ └── CHANGELOG.md ← Workspace-level changelog (PROTECTED)
├── variables-styles-extractor/ ← Project: Figma plugin
│ ├── AGENTS.md ← Project AI rules (canonical)
│ ├── CLAUDE.md ← Pointer to project AGENTS.md
│ ├── README.md ← Public-facing plugin docs
│ ├── LICENSE ← MIT + Figma CFRL distribution notice
│ ├── manifest.json ← Figma plugin manifest
│ ├── code.js ← Compiled output (CHECKED IN — no CI builds it)
│ ├── ui.html ← UI source
│ ├── src/code.ts ← Backend source (Figma QuickJS VM)
│ ├── .gcc/ ← Project session memory + build log
│ ├── .github/copilot-instructions.md
│ ├── docs/ ← AI_CONTEXT, CHANGELOG, CODING_STANDARDS, FIGMA_PLUGIN_DEVELOPMENT, etc.
│ └── releases/
├── nectar-design-toolkit/ ← Project: Design system toolkit (in development)
└── Design System Builder/ ← Project: Design system toolkit (in development)
└── variables-styles-extractor/ ← Project: Figma plugin (only active project)
├── AGENTS.md ← Project AI rules (canonical)
├── CLAUDE.md ← Pointer to project AGENTS.md
├── README.md ← Public-facing plugin docs
├── LICENSE ← MIT + Figma CFRL distribution notice
├── manifest.json ← Figma plugin manifest
├── code.js ← Compiled output (CHECKED IN — no CI builds it)
├── ui.html ← UI source
├── src/code.ts ← Backend source (Figma QuickJS VM)
├── .gcc/ ← Project session memory + build log
├── .github/copilot-instructions.md
├── docs/ ← AI_CONTEXT, CHANGELOG, CODING_STANDARDS, FIGMA_PLUGIN_DEVELOPMENT, etc.
└── releases/
```

---
Expand Down Expand Up @@ -147,4 +145,4 @@ Then update:

---

*Last updated: 2026-05-22 (Portfolio-style AI structure adopted)*
*Last updated: 2026-06-06 (`nectar-design-toolkit/` and `Design System Builder/` removed; workspace now hosts a single project)*
31 changes: 11 additions & 20 deletions docs/AI_CONTEXT.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,9 @@

## Workspace Context

This folder is part of a **multi-project workspace** and contains **multiple tool/plugin projects**:
This folder is part of a **multi-project workspace** that currently hosts
**one** active tool/plugin project. The layout is preserved so additional
projects can land alongside without restructuring.

```
design-docs/ ← Parent workspace root
Expand All @@ -28,11 +30,13 @@ design-docs/ ← Parent workspace root
│ └── Research Study/ ← Design system research (independent)
└── Side-Kicks/ ← THIS FOLDER (multi-project tools)
├── docs/ ← Folder-level docs
├── variables-styles-extractor/ ← Project: Figma plugin
├── nectar-design-toolkit/ ← Project: Design system orchestration
├── variables-styles-extractor/ ← Project: Figma plugin (only active)
└── [future-projects]/ ← Future tools/plugins
```

> Historical note: `nectar-design-toolkit/` and `Design System Builder/`
> were removed on 2026-06-06. See [`CHANGELOG.md`](CHANGELOG.md).

### 🗑️ Bin Folder (Fail-Safe)

Before deleting any file, move it to `bin/` first:
Expand Down Expand Up @@ -118,22 +122,9 @@ Each tool/plugin project lives in its **own subfolder** with a consistent struct
- Figma: https://www.figma.com/community/plugin/1584331992332668732
- GitHub: https://github.com/tknatwork/side-kicks

### 2. nectar-design-toolkit/
| Property | Value |
|----------|-------|
| **Purpose** | Multi-component suite for AI-controlled design system building in Figma |
| **Status** | Active - Migrated from Portfolio archive |
| **Version** | 1.0.0 |
| **Context** | `nectar-design-toolkit/docs/AI_CONTEXT.md` |
| **History** | `nectar-design-toolkit/docs/CHANGELOG.md` |

**Components:**
- **figma-plugin** - Main AI-controlled Figma plugin
- **nds-builder** - Standalone NDS bootstrapper
- **nectar-style-generator** - Style generation from variable modes
- **orchestration-server** - HTTP polling server for AI communication
- **bridge-server** - WebSocket bridge
- **mcp-server** - VS Code MCP integration
> Previously also: `nectar-design-toolkit/` (multi-component design-system
> suite) and `Design System Builder/` (Claude-native Figma toolkit). Both
> removed on 2026-06-06.

---

Expand Down Expand Up @@ -223,4 +214,4 @@ touch "Side-Kicks/[project-name]/.github/copilot-instructions.md"

---

*Last updated: Multi-project restructure*
*Last updated: 2026-06-06 (`nectar-design-toolkit/` and `Design System Builder/` removed; workspace collapsed to single active project)*
34 changes: 32 additions & 2 deletions docs/CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,37 @@
This changelog tracks **folder-level structure changes only**.

For project-specific changes, see each project's `CHANGELOG.md`:
- `variables-styles-extractor/CHANGELOG.md`
- `nectar-design-toolkit/CHANGELOG.md`
- `variables-styles-extractor/docs/CHANGELOG.md`

---

## [3.0.0] - 2026-06-06

### Removed
- **Project deletion**: `nectar-design-toolkit/` removed from the workspace.
Multi-component design-system orchestration suite (figma-plugin,
nds-builder, nectar-style-generator, orchestration-server, bridge-server,
mcp-server). Discontinued before reaching a published release.
- **Project deletion**: `Design System Builder/` removed from the workspace.
Claude-native Figma design system toolkit (pnpm workspace with
builder-plugin and installer). Discontinued before reaching a published
release.

### Changed
- Workspace collapses from three projects to one. `variables-styles-extractor/`
is now the sole active project. The multi-project layout (subfolder per
project, isolated lifecycles) is retained so future projects can land
without restructuring.
- `README.md`, `AGENTS.md`, `docs/AI_CONTEXT.md` updated to reflect the
single-project state and to record what was removed.
- `.github/dependabot.yml` cleaned: the 7 update entries scoped to the
deleted projects were removed.

### Migration notes
- No data loss for active users — neither deleted project shipped a public
release. Source remains in git history (commits `6ccb455`, `b83cce2`).
- Anyone with local clones should `git pull` to drop the deleted folders;
no manual cleanup is required.

---

Expand All @@ -18,6 +47,7 @@ For project-specific changes, see each project's `CHANGELOG.md`:
- **New Project**: `nectar-design-toolkit/` - Multi-component design system orchestration suite
- Migrated from `Portfolio/My Portfolio/_archive/NDS (planned)/AI_TOOLING/`
- Components: figma-plugin, nds-builder, nectar-style-generator, orchestration-server, bridge-server, mcp-server
- *Reverted by [3.0.0] on 2026-06-06 — project deleted.*

---

Expand Down
Loading