ai-devkit 0.4.2 → 0.6.0

package/web/components/MarkdownContent.tsx

@@ -1,35 +0,0 @@
-import { MDXRemote } from 'next-mdx-remote/rsc';
-import remarkGfm from 'remark-gfm';
-import rehypeHighlight from 'rehype-highlight';
-import rehypeSlug from 'rehype-slug';
-
-interface MarkdownContentProps {
-  content: string;
-}
-
-export default async function MarkdownContent({ content }: MarkdownContentProps) {
-  return (
-    <div className="prose prose-lg max-w-none
-      prose-headings:font-bold 
-      prose-h1:text-4xl prose-h1:mb-6
-      prose-h2:text-3xl prose-h2:mt-12 prose-h2:mb-4
-      prose-h3:text-2xl prose-h3:mt-8 prose-h3:mb-3
-      prose-p:text-gray-700 prose-p:leading-relaxed
-      prose-a:text-black prose-a:underline hover:prose-a:opacity-70
-      prose-code:bg-gray-100 prose-code:px-1 prose-code:py-0.5 prose-code:rounded prose-code:text-sm
-      prose-pre:bg-gray-900 prose-pre:text-gray-100
-      prose-ul:my-6 prose-li:my-2
-      prose-strong:font-bold prose-strong:text-black">
-      <MDXRemote
-        source={content}
-        options={{
-          mdxOptions: {
-            remarkPlugins: [remarkGfm],
-            rehypePlugins: [rehypeHighlight, rehypeSlug],
-          },
-        }}
-      />
-    </div>
-  );
-}
-

package/web/components/SkipToContent.tsx

@@ -1,11 +0,0 @@
-export default function SkipToContent() {
-  return (
-    <a
-      href="#main-content"
-      className="sr-only focus:not-sr-only focus:absolute focus:top-4 focus:left-4 focus:z-50 focus:px-4 focus:py-2 focus:bg-black focus:text-white focus:rounded-lg focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-black"
-    >
-      Skip to main content
-    </a>
-  );
-}
-

package/web/content/pages/vision.md

@@ -1,44 +0,0 @@
----
-title: Vision
-description: The vision and purpose behind AI DevKit
-slug: vision
-order: 2
----
-
-# Vision
-
-AI DevKit exists to bridge the gap between AI-assisted development and structured software engineering practices.
-
-## Our Purpose
-
-It inherits the idea from [The New Engineering Workflow](https://ownthecraftbook.com/chapters/9-the-new-engineering-workflow/) in [AI changes the Tools, you still own the Craft](https://ownthecraftbook.com/): empowering engineers to integrate AI effectively into a structured, test-driven, and craftsmanship-focused development process.
-
-We believe that AI coding assistants are most powerful when they work within a well-defined engineering framework where documentation is clear, plans are systematic, and architecture is intentional.
-
-AI DevKit provides the scaffolding for that structure. It helps engineers reduce the back-and-forth of prompting, keep context in sync, and share memory between themselves and their AI tools.
-
-Our goal is simple:
-To make working with AI feel as natural and reliable as working with your favorite teammate, the one who already knows your project, your style, and your standards.
-
-## What We're Building
-
-A toolkit that enables developers to:
-
-- **Document thoroughly** - Capture requirements, design decisions, and implementation notes in a consistent format
-- **Plan systematically** - Break down complex features into manageable tasks with clear dependencies
-- **Collaborate effectively** - Share context with AI assistants and human teammates through well-organized documentation
-- **Maintain quality** - Ensure testing coverage and code review processes are baked into the workflow
-
-## Our Principles
-
-1. **Documentation-first development** - Start with clear requirements before writing code
-2. **Phase-based workflow** - Move through requirements, design, planning, implementation, and testing in a structured way
-3. **AI-friendly context** - Organize project knowledge so AI assistants can provide better assistance
-4. **Low friction** - Make it easy to follow best practices without heavy tooling overhead
-
-## Looking Forward
-
-We envision a future where structured development practices are the default, not the exception. Where every feature starts with clear requirements and ends with comprehensive tests. Where AI assistants amplify human capabilities by working within well-defined frameworks.
-
-AI DevKit is our contribution to that future.
-

package/web/content/roadmap/1-web.md

@@ -1,9 +0,0 @@
----
-title: Public Website & Documentation
-status: completed
-priority: high
-order: 1
----
-
-Launch a static website with landing page, comprehensive documentation, project vision, and development roadmap.
-

package/web/content/roadmap/2-integrations.md

@@ -1,7 +0,0 @@
----
-title: Coding Agent Integration
-status: in-progress
-order: 2
----
-
-Expand AI DevKit’s ecosystem with other AI coding agents such as: ChatGPT Codex, Gemini CLI, etc. The goal is to make AI DevKit the universal bridge between your favorite AI assistants and your development workflow, enabling smoother collaboration, faster iteration, and more consistent results.

package/web/content/roadmap/3-cli-enhancements.md

@@ -1,8 +0,0 @@
----
-title: CLI Enhancements & Workflows
-status: planned
-order: 2
----
-
-Expand CLI capabilities with interactive workflows, better error handling, and enhanced command chaining. Focus on improving developer experience and reducing friction in the structured development process.
-

package/web/content/roadmap/4-local-memory.md

@@ -1,8 +0,0 @@
----
-title: Local Memory & Knowledge based
-status: planned
-order: 4
----
-
-Build a local AI memory that learns from your coding habits, preferences, and team knowledge.
-This feature allows AI agents to access your skills, patterns, and project context directly from local, minimizing redundant prompts, speeding up workflows, and keeping your documents lightweight and focused.

package/web/eslint.config.mjs

@@ -1,18 +0,0 @@
-import { defineConfig, globalIgnores } from "eslint/config";
-import nextVitals from "eslint-config-next/core-web-vitals";
-import nextTs from "eslint-config-next/typescript";
-
-const eslintConfig = defineConfig([
-  ...nextVitals,
-  ...nextTs,
-  // Override default ignores of eslint-config-next.
-  globalIgnores([
-    // Default ignores of eslint-config-next:
-    ".next/**",
-    "out/**",
-    "build/**",
-    "next-env.d.ts",
-  ]),
-]);
-
-export default eslintConfig;

package/web/lib/GitHubContext.tsx

@@ -1,57 +0,0 @@
-'use client';
-
-import { createContext, useContext, useState, useEffect, ReactNode } from 'react';
-
-interface GitHubContextType {
-  stars: number | null;
-  loading: boolean;
-}
-
-const GitHubContext = createContext<GitHubContextType>({
-  stars: null,
-  loading: true,
-});
-
-export function GitHubProvider({ 
-  children, 
-  repo 
-}: { 
-  children: ReactNode; 
-  repo: string;
-}) {
-  const [stars, setStars] = useState<number | null>(null);
-  const [loading, setLoading] = useState(true);
-
-  useEffect(() => {
-    async function fetchStars() {
-      try {
-        const response = await fetch(`https://api.github.com/repos/${repo}`);
-        if (response.ok) {
-          const data = await response.json();
-          setStars(data.stargazers_count);
-        }
-      } catch (error) {
-        console.error('Failed to fetch GitHub stars:', error);
-      } finally {
-        setLoading(false);
-      }
-    }
-
-    fetchStars();
-  }, [repo]);
-
-  return (
-    <GitHubContext.Provider value={{ stars, loading }}>
-      {children}
-    </GitHubContext.Provider>
-  );
-}
-
-export function useGitHubStars() {
-  const context = useContext(GitHubContext);
-  if (!context) {
-    throw new Error('useGitHubStars must be used within a GitHubProvider');
-  }
-  return context;
-}
-

package/web/lib/content/loader.ts

@@ -1,152 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import matter from 'gray-matter';
-import { Page, PageMetadata, RoadmapItem, RoadmapItemMetadata } from './types';
-
-const contentDirectory = path.join(process.cwd(), 'content');
-const docsDirectory = path.join(contentDirectory, 'docs');
-const pagesDirectory = path.join(contentDirectory, 'pages');
-
-/**
- * Get all Markdown files from a directory
- */
-function getMarkdownFiles(dir: string): string[] {
-  if (!fs.existsSync(dir)) {
-    return [];
-  }
-  
-  const files = fs.readdirSync(dir);
-  return files
-    .filter(file => file.endsWith('.md') || file.endsWith('.mdx'))
-    .map(file => path.join(dir, file));
-}
-
-/**
- * Parse a Markdown file with frontmatter
- */
-function parseMarkdownFile<T>(filePath: string): { metadata: T; content: string } {
-  const fileContents = fs.readFileSync(filePath, 'utf8');
-  const { data, content } = matter(fileContents);
-  
-  return {
-    metadata: data as T,
-    content: content.trim(),
-  };
-}
-
-/**
- * Get a single page by slug
- */
-export function getPage(slug: string): Page | null {
-  const filePath = path.join(pagesDirectory, `${slug}.md`);
-  
-  if (!fs.existsSync(filePath)) {
-    return null;
-  }
-  
-  const parsed = parseMarkdownFile<PageMetadata>(filePath);
-  
-  return {
-    metadata: {
-      ...parsed.metadata,
-      slug,
-    },
-    content: parsed.content,
-  };
-}
-
-/**
- * Get all pages
- */
-export function getAllPages(): Page[] {
-  const files = getMarkdownFiles(pagesDirectory);
-  
-  const pages = files.map(filePath => {
-    const slug = path.basename(filePath, path.extname(filePath));
-    const parsed = parseMarkdownFile<PageMetadata>(filePath);
-    
-    return {
-      metadata: {
-        ...parsed.metadata,
-        slug,
-      },
-      content: parsed.content,
-    };
-  });
-  
-  // Sort by order if specified
-  return pages.sort((a, b) => {
-    const orderA = a.metadata.order ?? 999;
-    const orderB = b.metadata.order ?? 999;
-    return orderA - orderB;
-  });
-}
-
-/**
- * Get a single documentation page by slug
- */
-export function getDocPage(slug: string): Page | null {
-  const filePath = path.join(docsDirectory, `${slug}.md`);
-  
-  if (!fs.existsSync(filePath)) {
-    return null;
-  }
-  
-  const parsed = parseMarkdownFile<PageMetadata>(filePath);
-  
-  return {
-    metadata: {
-      ...parsed.metadata,
-      slug,
-    },
-    content: parsed.content,
-  };
-}
-
-/**
- * Get all documentation pages
- */
-export function getAllDocPages(): Page[] {
-  const files = getMarkdownFiles(docsDirectory);
-  
-  const pages = files.map(filePath => {
-    const slug = path.basename(filePath, path.extname(filePath));
-    const parsed = parseMarkdownFile<PageMetadata>(filePath);
-    
-    return {
-      metadata: {
-        ...parsed.metadata,
-        slug,
-      },
-      content: parsed.content,
-    };
-  });
-  
-  // Sort by order if specified
-  return pages.sort((a, b) => {
-    const orderA = a.metadata.order ?? 999;
-    const orderB = b.metadata.order ?? 999;
-    return orderA - orderB;
-  });
-}
-
-/**
- * Get all roadmap items
- */
-export function getRoadmap(): RoadmapItem[] {
-  const roadmapDir = path.join(contentDirectory, 'roadmap');
-  const files = getMarkdownFiles(roadmapDir);
-  
-  const items = files.map(filePath => {
-    const parsed = parseMarkdownFile<RoadmapItemMetadata>(filePath);
-    return parsed as RoadmapItem;
-  });
-  
-  // Sort by order if specified, then by priority
-  return items.sort((a, b) => {
-    const orderA = a.metadata.order ?? 999;
-    const orderB = b.metadata.order ?? 999;
-    return orderA - orderB;
-  });
-}
-

package/web/lib/content/types.ts

@@ -1,37 +0,0 @@
-export interface PageMetadata {
-  title: string;
-  description: string;
-  slug: string;
-  heroImage?: string;
-  order?: number;
-}
-
-export interface Page {
-  metadata: PageMetadata;
-  content: string;
-}
-
-export interface RoadmapItemMetadata {
-  title: string;
-  status: 'planned' | 'in-progress' | 'completed' | 'on-hold';
-  timeframe?: string;
-  priority?: 'low' | 'medium' | 'high';
-  order?: number;
-}
-
-export interface RoadmapItem {
-  metadata: RoadmapItemMetadata;
-  content: string;
-}
-
-export interface NavigationLink {
-  label: string;
-  href: string;
-  external?: boolean;
-}
-
-export interface NavigationSection {
-  title: string;
-  links: NavigationLink[];
-}
-

package/web/lib/utils.ts

@@ -1,12 +0,0 @@
-/**
- * Format star count for display
- * @param count - The number of stars
- * @returns Formatted string (e.g., "1.5k" for 1500)
- */
-export function formatStars(count: number): string {
-  if (count >= 1000) {
-    return `${(count / 1000).toFixed(1)}k`;
-  }
-  return count.toString();
-}
-

package/web/next.config.ts

@@ -1,11 +0,0 @@
-import type { NextConfig } from "next";
-
-const nextConfig: NextConfig = {
-  output: 'export',
-  images: {
-    unoptimized: true,
-  },
-  trailingSlash: true,
-};
-
-export default nextConfig;