@vpxa/aikit 0.1.207 → 0.1.208

package/scaffold/dist/definitions/plugins.mjs

@@ -1 +1 @@
-const e={aikit:{description:`AI Kit search, analysis, memory, and developer tools`,source:`scaffold/skills/aikit/SKILL.md`,required:!0},brainstorming:{description:`Brainstorming & design exploration workflow`,source:`scaffold/skills/brainstorming/SKILL.md`,required:!0,sidecars:[`scaffold/skills/brainstorming/spec-document-reviewer-prompt.md`]},"multi-agents-development":{description:`Multi-agent orchestration, task decomposition, parallel dispatch, and review pipeline patterns`,source:`scaffold/skills/multi-agents-development/SKILL.md`,required:!0,sidecars:[`scaffold/skills/multi-agents-development/implementer-prompt.md`,`scaffold/skills/multi-agents-development/spec-review-prompt.md`,`scaffold/skills/multi-agents-development/code-quality-review-prompt.md`,`scaffold/skills/multi-agents-development/architecture-review-prompt.md`,`scaffold/skills/multi-agents-development/parallel-dispatch-example.md`]},"adr-skill":{description:`Architecture Decision Records — create, maintain, and review ADRs for significant technical decisions`,source:`scaffold/skills/adr-skill/SKILL.md`,required:!0,sidecars:[`scaffold/skills/adr-skill/assets/templates/adr-madr.md`,`scaffold/skills/adr-skill/assets/templates/adr-readme.md`,`scaffold/skills/adr-skill/assets/templates/adr-simple.md`,`scaffold/skills/adr-skill/references/adr-conventions.md`,`scaffold/skills/adr-skill/references/examples.md`,`scaffold/skills/adr-skill/references/review-checklist.md`,`scaffold/skills/adr-skill/references/template-variants.md`,`scaffold/skills/adr-skill/scripts/bootstrap_adr.js`,`scaffold/skills/adr-skill/scripts/new_adr.js`,`scaffold/skills/adr-skill/scripts/set_adr_status.js`]},"c4-architecture":{description:`C4 model architecture diagrams using Mermaid — system context, container, component, and deployment views`,source:`scaffold/skills/c4-architecture/SKILL.md`,required:!0,sidecars:[`scaffold/skills/c4-architecture/references/advanced-patterns.md`,`scaffold/skills/c4-architecture/references/c4-syntax.md`,`scaffold/skills/c4-architecture/references/c4.schema.json`,`scaffold/skills/c4-architecture/references/common-mistakes.md`]},"frontend-design":{description:`Frontend design system — visual design thinking, typography, color, layout, motion, accessibility, and anti-pattern detection`,source:`scaffold/skills/frontend-design/SKILL.md`,required:!1},"lesson-learned":{description:`Extract engineering lessons from recent code changes via git history analysis`,source:`scaffold/skills/lesson-learned/SKILL.md`,required:!0,sidecars:[`scaffold/skills/lesson-learned/references/anti-patterns.md`,`scaffold/skills/lesson-learned/references/se-principles.md`]},present:{description:`Rich interactive dashboards, charts, tables, timelines, and data visualizations via the present MCP tool`,source:`scaffold/skills/present/SKILL.md`,required:!0},react:{description:`React development patterns — component architecture, React 19 APIs, Server Components, TypeScript integration`,source:`scaffold/skills/react/SKILL.md`,required:!1},"requirements-clarity":{description:`Clarify ambiguous requirements through focused dialogue — score 0-100 until ≥90 before implementation`,source:`scaffold/skills/requirements-clarity/SKILL.md`,required:!0},"session-handoff":{description:`Comprehensive handoff documents for seamless AI agent session transfers and context preservation`,source:`scaffold/skills/session-handoff/SKILL.md`,required:!0,sidecars:[`scaffold/skills/session-handoff/references/handoff-template.md`,`scaffold/skills/session-handoff/references/resume-checklist.md`,`scaffold/skills/session-handoff/scripts/check_staleness.js`,`scaffold/skills/session-handoff/scripts/create_handoff.js`,`scaffold/skills/session-handoff/scripts/list_handoffs.js`,`scaffold/skills/session-handoff/scripts/validate_handoff.js`]},typescript:{description:`TypeScript development patterns — type system, compiler config, advanced types, async patterns, module organization`,source:`scaffold/skills/typescript/SKILL.md`,required:!1},docs:{description:`Living documentation management — Diátaxis framework, docs/ convention, staleness detection, integration with adr-skill and c4-architecture`,source:`scaffold/skills/docs/SKILL.md`,required:!0},"repo-access":{description:`Progressive repository access recovery for private and enterprise git repos — strategy ladder from HTTPS to SSH to CLI OAuth to PAT to local clone`,source:`scaffold/skills/repo-access/SKILL.md`,required:!0,sidecars:[`scaffold/skills/repo-access/references/platform-matrix.md`,`scaffold/skills/repo-access/references/error-patterns.md`]},"browser-use":{description:`AI Kit owned browser runtime — zero setup authentication recovery, data extraction, form filling, and web interaction. Built-in Chromium with headless/UI/panel modes. Pairs with repo-access as final escalation for SSO/login wall recovery.`,source:`scaffold/skills/browser-use/SKILL.md`,required:!1,sidecars:[`scaffold/skills/browser-use/references/recipes.md`,`scaffold/skills/browser-use/references/auth-patterns.md`]}};export{e as PLUGINS};
+const e={aikit:{description:`AI Kit search, analysis, memory, and developer tools`,source:`scaffold/skills/aikit/SKILL.md`,required:!0,triggerKeywords:[`aikit`,`mcp`,`tools`,`search`,`memory`,`index`,`reindex`],triggerPatterns:[`\\baikit\\b`,`\\bmcp\\b`,`vector\\s+search`,`persistent\\s+memory`],triggerExamples:{positive:[`use AI Kit tools to search the codebase`,`check the MCP index status`],negative:[`build a React component`,`draw a deployment diagram`]},priority:9},brainstorming:{description:`Brainstorming & design exploration workflow`,source:`scaffold/skills/brainstorming/SKILL.md`,required:!0,triggerKeywords:[`design`,`explore`,`options`,`approach`,`how should`,`brainstorm`],triggerPatterns:[`how\\s+should`,`explore\\s+options`,`best\\s+way`,`approach\\s+for`],triggerExamples:{positive:[`how should I design this feature`,`explore options for the API approach`],negative:[`implement the approved design`,`fix the failing unit test`]},priority:8,sidecars:[`scaffold/skills/brainstorming/spec-document-reviewer-prompt.md`]},"multi-agents-development":{description:`Multi-agent orchestration, task decomposition, parallel dispatch, and review pipeline patterns`,source:`scaffold/skills/multi-agents-development/SKILL.md`,required:!0,triggerKeywords:[`multi-agent`,`parallel`,`orchestrate`,`dispatch`,`task decomposition`,`review pipeline`],triggerPatterns:[`multi-agent`,`parallel\\s+dispatch`,`task\\s+decomposition`,`review\\s+pipeline`],triggerExamples:{positive:[`orchestrate multiple agents in parallel`,`dispatch reviewers after implementation`],negative:[`debug a single failing function`,`write one documentation page`]},priority:7,sidecars:[`scaffold/skills/multi-agents-development/implementer-prompt.md`,`scaffold/skills/multi-agents-development/spec-review-prompt.md`,`scaffold/skills/multi-agents-development/code-quality-review-prompt.md`,`scaffold/skills/multi-agents-development/architecture-review-prompt.md`,`scaffold/skills/multi-agents-development/parallel-dispatch-example.md`]},"adr-skill":{description:`Architecture Decision Records — create, maintain, and review ADRs for significant technical decisions`,source:`scaffold/skills/adr-skill/SKILL.md`,required:!0,triggerKeywords:[`adr`,`architecture`,`decision`,`tradeoff`,`choose between`,`design decision`],triggerPatterns:[`\\badr\\b`,`trade[- ]?off`,`choose\\s+between`,`design\\s+the\\s+.*flow`],triggerExamples:{positive:[`write an ADR for this service boundary`,`choose between two queue architectures`],negative:[`implement the selected option`,`fix the CSS bug`]},priority:8,sidecars:[`scaffold/skills/adr-skill/assets/templates/adr-madr.md`,`scaffold/skills/adr-skill/assets/templates/adr-readme.md`,`scaffold/skills/adr-skill/assets/templates/adr-simple.md`,`scaffold/skills/adr-skill/references/adr-conventions.md`,`scaffold/skills/adr-skill/references/examples.md`,`scaffold/skills/adr-skill/references/review-checklist.md`,`scaffold/skills/adr-skill/references/template-variants.md`,`scaffold/skills/adr-skill/scripts/bootstrap_adr.js`,`scaffold/skills/adr-skill/scripts/new_adr.js`,`scaffold/skills/adr-skill/scripts/set_adr_status.js`]},"c4-architecture":{description:`C4 model architecture diagrams using Mermaid — system context, container, component, and deployment views`,source:`scaffold/skills/c4-architecture/SKILL.md`,required:!0,triggerKeywords:[`architecture diagram`,`c4`,`system context`,`container`,`component diagram`,`deployment view`],triggerPatterns:[`architecture\\s+diagram`,`\\bc4\\b`,`system\\s+context`,`container\\s+diagram`],triggerExamples:{positive:[`create architecture diagram for the platform`,`draw a C4 container view`],negative:[`show a sales dashboard`,`write API documentation`]},priority:8,sidecars:[`scaffold/skills/c4-architecture/references/advanced-patterns.md`,`scaffold/skills/c4-architecture/references/c4-syntax.md`,`scaffold/skills/c4-architecture/references/c4.schema.json`,`scaffold/skills/c4-architecture/references/common-mistakes.md`]},"frontend-design":{description:`Frontend design system — visual design thinking, typography, color, layout, motion, accessibility, and anti-pattern detection`,source:`scaffold/skills/frontend-design/SKILL.md`,required:!1,triggerKeywords:[`ui`,`ux`,`design system`,`typography`,`color`,`layout`,`accessibility`],triggerPatterns:[`\\bui\\b`,`\\bux\\b`,`design\\s+system`,`color\\s+palette`,`page\\s+layout`],triggerExamples:{positive:[`improve the UI layout and typography`,`design a new onboarding UX`],negative:[`fix a server timeout`,`rotate API keys`]},priority:7},"lesson-learned":{description:`Extract engineering lessons from recent code changes via git history analysis`,source:`scaffold/skills/lesson-learned/SKILL.md`,required:!0,triggerKeywords:[`lesson`,`takeaway`,`reflect`,`what did I learn`,`retrospective`],triggerPatterns:[`what\\s+did\\s+i\\s+learn`,`lesson\\s+learned`,`takeaway`,`reflect\\s+on`],triggerExamples:{positive:[`what did I learn from this refactor`,`capture an engineering takeaway`],negative:[`implement the refactor`,`open the browser and log in`]},priority:6,sidecars:[`scaffold/skills/lesson-learned/references/anti-patterns.md`,`scaffold/skills/lesson-learned/references/se-principles.md`]},present:{description:`Rich interactive dashboards, charts, tables, timelines, and data visualizations via the present MCP tool`,source:`scaffold/skills/present/SKILL.md`,required:!0,triggerKeywords:[`dashboard`,`chart`,`visual`,`table`,`display`,`render`,`timeline`],triggerPatterns:[`\\bdashboard\\b`,`\\bchart\\b`,`data\\s+visual`,`render\\s+a\\s+table`],triggerExamples:{positive:[`show a dashboard with charts`,`render a results table for the user`],negative:[`parse a JSON response`,`compile TypeScript types`]},priority:7},react:{description:`React development patterns — component architecture, React 19 APIs, Server Components, TypeScript integration`,source:`scaffold/skills/react/SKILL.md`,required:!1,triggerKeywords:[`react`,`component`,`jsx`,`tsx`,`hooks`,`useState`,`useEffect`,`server components`],triggerPatterns:[`\\.tsx$`,`\\.(?:jsx|tsx)\\b`,`\\b(?:react|preact)\\b`,`\\buse[A-Z]\\w+`],triggerExamples:{positive:[`build a React form`,`fix the useEffect hook`,`add a new component`],negative:[`react to the error`,`create a Go server`]},priority:8},"requirements-clarity":{description:`Clarify ambiguous requirements through focused dialogue — score 0-100 until ≥90 before implementation`,source:`scaffold/skills/requirements-clarity/SKILL.md`,required:!0,triggerKeywords:[`requirements`,`unclear`,`ambiguous`,`complex feature`,`build`,`clarify`,`scope`],triggerPatterns:[`clarify\\s+requirements`,`complex\\s+feature`,`what\\s+exactly`,`scope\\s+this`],triggerExamples:{positive:[`the requirements are unclear for this feature`,`help scope this complex build`],negative:[`the spec is final, implement it`,`rename this file`]},priority:8},"session-handoff":{description:`Comprehensive handoff documents for seamless AI agent session transfers and context preservation`,source:`scaffold/skills/session-handoff/SKILL.md`,required:!0,triggerKeywords:[`handoff`,`context`,`pause`,`resume`,`save state`,`continue later`],triggerPatterns:[`save\\s+state`,`resume\\s+from`,`continue\\s+where\\s+we\\s+left\\s+off`,`handoff`],triggerExamples:{positive:[`create a handoff before I pause`,`resume from the saved context`],negative:[`finish the current task now`,`run the build and keep going`]},priority:7,sidecars:[`scaffold/skills/session-handoff/references/handoff-template.md`,`scaffold/skills/session-handoff/references/resume-checklist.md`,`scaffold/skills/session-handoff/scripts/check_staleness.js`,`scaffold/skills/session-handoff/scripts/create_handoff.js`,`scaffold/skills/session-handoff/scripts/list_handoffs.js`,`scaffold/skills/session-handoff/scripts/validate_handoff.js`]},typescript:{description:`TypeScript development patterns — type system, compiler config, advanced types, async patterns, module organization`,source:`scaffold/skills/typescript/SKILL.md`,required:!1,triggerKeywords:[`typescript`,`ts`,`types`,`interface`,`generics`,`tsconfig`,`compiler`],triggerPatterns:[`\\btypescript\\b`,`\\btsconfig\\b`,`interface\\s+\\w+`,`generic\\s+type`],triggerExamples:{positive:[`fix the TypeScript interface`,`update tsconfig for stricter types`],negative:[`style the landing page`,`create a shell alias`]},priority:8},docs:{description:`Living documentation management — Diátaxis framework, docs/ convention, staleness detection, integration with adr-skill and c4-architecture`,source:`scaffold/skills/docs/SKILL.md`,required:!0,triggerKeywords:[`documentation`,`readme`,`guide`,`tutorial`,`docs`,`how-to`],triggerPatterns:[`\\breadme\\b`,`\\bdocs?\\b`,`write\\s+a\\s+guide`,`update\\s+documentation`],triggerExamples:{positive:[`update the README guide`,`write documentation for this workflow`],negative:[`fix the runtime bug`,`draw a chart`]},priority:7},"repo-access":{description:`Progressive repository access recovery for private and enterprise git repos — strategy ladder from HTTPS to SSH to CLI OAuth to PAT to local clone`,source:`scaffold/skills/repo-access/SKILL.md`,required:!0,triggerKeywords:[`auth`,`401`,`403`,`private repo`,`enterprise`,`permission denied`,`ssh`],triggerPatterns:[`\\b401\\b`,`\\b403\\b`,`private\\s+repo`,`permission\\s+denied`,`git\\s+auth`],triggerExamples:{positive:[`I get 403 on this private repo`,`help recover enterprise git auth`],negative:[`compare two public repositories`,`write a deployment ADR`]},priority:8,sidecars:[`scaffold/skills/repo-access/references/platform-matrix.md`,`scaffold/skills/repo-access/references/error-patterns.md`]},"browser-use":{description:`AI Kit owned browser runtime — zero setup authentication recovery, data extraction, form filling, and web interaction. Built-in Chromium with headless/UI/panel modes. Pairs with repo-access as final escalation for SSO/login wall recovery.`,source:`scaffold/skills/browser-use/SKILL.md`,required:!1,triggerKeywords:[`browser`,`login`,`saml`,`captcha`,`scrape`,`form filling`,`chromium`],triggerPatterns:[`\\bbrowser\\b`,`\\blogin\\b`,`\\bsaml\\b`,`\\bcaptcha\\b`,`scrap(?:e|ing)`],triggerExamples:{positive:[`use the browser to log in through SAML`,`scrape data after clicking through the form`],negative:[`fetch a static markdown page`,`rename a TypeScript symbol`]},priority:7,sidecars:[`scaffold/skills/browser-use/references/recipes.md`,`scaffold/skills/browser-use/references/auth-patterns.md`]}};export{e as PLUGINS};

package/scaffold/dist/definitions/policies.mjs

@@ -0,0 +1,2 @@
+const e=[{id:`no-grep-search`,forbidden:`grep_search`,alternative:`search`,severity:`error`,reason:`Hybrid search across all indexed + curated content`,matchPattern:`grep_search`},{id:`no-semantic-search`,forbidden:`semantic_search`,alternative:`search`,severity:`error`,reason:`Hybrid search across all indexed + curated content`,matchPattern:`semantic_search`},{id:`no-read-file-understanding`,forbidden:`read_file (for understanding)`,alternative:`file_summary or compact`,severity:`error`,reason:`Structure, exports, imports — 10x fewer tokens`,matchPattern:null,heuristic:`read_file with range > 50 lines and no subsequent edit`},{id:`no-terminal-test`,forbidden:`run_in_terminal (for test)`,alternative:`test_run`,severity:`error`,reason:`Run tests with structured output`,matchPattern:null,commandPatterns:[`vitest`,`jest`,`mocha`,`pnpm test`,`npm test`]},{id:`no-terminal-typecheck`,forbidden:`run_in_terminal (for tsc/lint)`,alternative:`check`,severity:`error`,reason:`Typecheck + lint combined, summary output`,matchPattern:null,commandPatterns:[`\\btsc\\b`,`pnpm check`,`pnpm typecheck`,`pnpm lint`,`biome`]},{id:`no-terminal-grep`,forbidden:`run_in_terminal (for find/grep)`,alternative:`find or search`,severity:`error`,reason:`No shell needed, richer results`,matchPattern:null,commandPatterns:[`\\bgrep\\b`,`\\bfind\\b`,`\\brg\\b`,`Select-String`]},{id:`no-read-file-large`,forbidden:`read_file (> 50 lines to understand)`,alternative:`file_summary → compact → digest`,severity:`warning`,reason:`Use compressed context, not raw reads`,matchPattern:null,heuristic:`read_file with endLine - startLine > 50 and no subsequent edit on same file`},{id:`no-fetch-webpage`,forbidden:`fetch_webpage`,alternative:`web_fetch`,severity:`error`,reason:`Readability extract + token budget — richer output`,matchPattern:`fetch_webpage`},{id:`no-subagent-present`,forbidden:`present (from subagent)`,alternative:`Return findings as structured text`,severity:`error`,reason:`Subagent present calls are invisible to user`,matchPattern:null,heuristic:`present called in subagent context`}];function t(){return[`| NEVER use this | USE THIS AI Kit TOOL INSTEAD | Why |`,`|---|---|---|`,...e.filter(e=>e.severity===`error`).map(e=>`| \`${e.forbidden}\` | \`${e.alternative}\` | ${e.reason} |`)].join(`
+`)}function n(){return e.map(e=>({id:e.id,description:`${e.forbidden} → use ${e.alternative}`,toolMatch:e.matchPattern,commandPatterns:e.commandPatterns??null,heuristic:e.heuristic??null}))}export{e as POLICIES,t as generateForbiddenTable,n as generateScorerRules};

package/scaffold/scripts/compile-policies.mjs

@@ -0,0 +1,31 @@
+#!/usr/bin/env node
+/**
+ * Compiles policies.mjs into downstream artifacts.
+ * Run: node scaffold/scripts/compile-policies.mjs
+ *
+ * Outputs:
+ * 1. Validates policies are consistent
+ * 2. Prints the generated FORBIDDEN table (for manual verification)
+ * 3. Could be extended to auto-patch server-instructions/bodies
+ */
+import { generateForbiddenTable, generateScorerRules, POLICIES } from '../definitions/policies.mjs';
+
+console.log('=== Policy Compilation ===');
+console.log(`Total policies: ${POLICIES.length}`);
+console.log(`Error-level: ${POLICIES.filter((policy) => policy.severity === 'error').length}`);
+console.log(`Warning-level: ${POLICIES.filter((policy) => policy.severity === 'warning').length}`);
+console.log('');
+console.log('=== Generated FORBIDDEN Table ===');
+console.log(generateForbiddenTable());
+console.log('');
+console.log('=== Generated Scorer Rules ===');
+console.log(JSON.stringify(generateScorerRules(), null, 2));
+
+const ids = POLICIES.map((policy) => policy.id);
+const duplicateIds = ids.filter((id, index) => ids.indexOf(id) !== index);
+if (duplicateIds.length > 0) {
+  console.error(`\nERROR: Duplicate policy IDs: ${duplicateIds.join(', ')}`);
+  process.exit(1);
+}
+
+console.log('\n✓ All policies valid');