From dfbd1c62953ebc61bab5ff2a3a972a8b88151f82 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 6 Jun 2026 12:55:41 +0000 Subject: [PATCH 1/2] docs: sync workspace files after Nectar + DSB deletion Updates the workspace-level docs and Dependabot config to reflect main after commits 6ccb455 and b83cce2 deleted nectar-design-toolkit/ and Design System Builder/. Changes: - README.md: projects table collapses to the single remaining project; repo layout tree drops the deleted siblings; "previously hosted" note links to CHANGELOG. - AGENTS.md: "What this repo is" table collapses to one row; project scope rules collapse from three-project to single-project shape; verified date bumped. - docs/AI_CONTEXT.md: workspace tree and "Current Projects" section drop the nectar-design-toolkit entry; historical note added. - docs/CHANGELOG.md: new [3.0.0] entry logs both deletions, migration notes, and the documentation sweep. Dead reference to nectar-design-toolkit/CHANGELOG.md removed; the v2.1.0 entry annotated as reverted. - .github/dependabot.yml: 7 npm update entries removed (1 for Design System Builder, 6 for nectar-design-toolkit subprojects). Workspace Dependabot config now scoped only to variables-styles-extractor + GitHub Actions. The multi-project workspace layout is preserved so future projects can land without restructuring. https://claude.ai/code/session_017J9nRWaZWvigeBz7nDej2h --- .github/dependabot.yml | 79 ------------------------------------------ AGENTS.md | 15 ++++---- README.md | 34 +++++++++--------- docs/AI_CONTEXT.md | 31 ++++++----------- docs/CHANGELOG.md | 34 ++++++++++++++++-- 5 files changed, 67 insertions(+), 126 deletions(-) diff --git a/.github/dependabot.yml b/.github/dependabot.yml index 84b29a8..9be3bd3 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -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" diff --git a/AGENTS.md b/AGENTS.md index 25c3f1c..6303ff9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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 === --> @@ -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. --- @@ -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 @@ -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)* diff --git a/README.md b/README.md index c254314..649803c 100644 --- a/README.md +++ b/README.md @@ -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. --- @@ -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/ ``` --- @@ -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)* diff --git a/docs/AI_CONTEXT.md b/docs/AI_CONTEXT.md index 6b884e4..04124d1 100644 --- a/docs/AI_CONTEXT.md +++ b/docs/AI_CONTEXT.md @@ -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 @@ -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: @@ -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. --- @@ -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)* diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md index 390b4a6..9afb1fb 100644 --- a/docs/CHANGELOG.md +++ b/docs/CHANGELOG.md @@ -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. --- @@ -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.* --- From b6c4c0d1156223008c62275dff2123e0ae041140 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 6 Jun 2026 13:03:49 +0000 Subject: [PATCH 2/2] ci: pin CodeQL source-root to plugin folder so docs-only PRs scan MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit After the 2026-06-06 deletion of Design System Builder/ and nectar-design-toolkit/, the plugin folder is the only location with JS/TS source in the repo. CodeQL's diff-informed autobuilder was extracting only files in the PR diff, and on docs-only PRs that meant zero JS/TS source — the JS extractor exited with code 32 ("no source code seen during build"). Fix: pin `source-root` to `variables-styles-extractor` and add a config-file (.github/codeql-config.yml) that excludes archived releases/, pre-rewrite backups, and any future node_modules. Every PR now scans the plugin code uniformly, regardless of diff contents. The earlier scope-doc PRs (#19, #20, #21) passed CodeQL because they were branched off pre-deletion main, which still contained JS/TS in the two deleted projects. Going forward, all PRs land against the post-deletion main and need this config to scan cleanly. https://claude.ai/code/session_017J9nRWaZWvigeBz7nDej2h --- .github/codeql-config.yml | 19 +++++++++++++++++++ .github/workflows/codeql.yml | 9 +++++++++ 2 files changed, 28 insertions(+) create mode 100644 .github/codeql-config.yml diff --git a/.github/codeql-config.yml b/.github/codeql-config.yml new file mode 100644 index 0000000..c2fc97f --- /dev/null +++ b/.github/codeql-config.yml @@ -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 diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml index 42cb134..63bd409 100644 --- a/.github/workflows/codeql.yml +++ b/.github/workflows/codeql.yml @@ -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