omgkit 2.10.0 → 2.11.0

package/plugin/templates/autonomous/features-schema.yaml

@@ -0,0 +1,254 @@
+# Features Schema for Autonomous Projects
+# This defines the structure of .omgkit/generated/features.yaml
+
+version: 1
+
+schema:
+  # Metadata
+  project_name:
+    type: string
+    required: true
+    description: Project name for reference
+
+  generated_at:
+    type: datetime
+    required: true
+    description: When feature list was generated
+
+  source:
+    type: string
+    required: true
+    description: PRD file this was generated from
+
+  # Feature priorities
+  priorities:
+    p0:
+      type: array
+      items: feature
+      description: Must-have features for MVP
+
+    p1:
+      type: array
+      items: feature
+      description: Should-have features
+
+    p2:
+      type: array
+      items: feature
+      description: Nice-to-have features
+
+    out_of_scope:
+      type: array
+      items: string
+      description: Explicitly excluded features
+
+  # Feature definition
+  feature:
+    id:
+      type: string
+      required: true
+      pattern: "^[a-z][a-z0-9_]*$"
+      description: Unique feature identifier
+
+    name:
+      type: string
+      required: true
+      description: Human-readable feature name
+
+    description:
+      type: string
+      required: true
+      description: What this feature does
+
+    priority:
+      type: string
+      enum: [p0, p1, p2]
+      required: true
+      description: Feature priority
+
+    category:
+      type: string
+      enum: [auth, data, ui, api, integration, infrastructure, other]
+      description: Feature category
+
+    phase:
+      type: string
+      description: Which phase this feature belongs to
+
+    dependencies:
+      type: array
+      items: string
+      description: IDs of features this depends on
+
+    # Implementation details
+    implementation:
+      approach:
+        type: string
+        description: How to implement this feature
+
+      files:
+        type: array
+        items: string
+        description: Files to create/modify
+
+      models:
+        type: array
+        items: string
+        description: Data models needed
+
+      apis:
+        type: array
+        items: string
+        description: API endpoints needed
+
+      components:
+        type: array
+        items: string
+        description: UI components needed
+
+    # Testing requirements
+    testing:
+      unit_tests:
+        type: array
+        items: string
+        description: Unit tests to write
+
+      integration_tests:
+        type: array
+        items: string
+        description: Integration tests to write
+
+      acceptance_criteria:
+        type: array
+        items: string
+        description: Acceptance criteria from PRD
+
+    # Progress tracking
+    status:
+      type: string
+      enum: [pending, in_progress, completed, skipped, blocked]
+      default: pending
+      description: Current feature status
+
+    progress:
+      steps_total:
+        type: integer
+        description: Total implementation steps
+
+      steps_completed:
+        type: integer
+        default: 0
+        description: Completed steps
+
+      tests_total:
+        type: integer
+        description: Total tests to write
+
+      tests_passed:
+        type: integer
+        default: 0
+        description: Passing tests
+
+    # Autonomy settings
+    autonomy:
+      level:
+        type: integer
+        enum: [0, 1, 2, 3, 4]
+        default: 1
+        description: Override autonomy level for this feature
+
+      reason:
+        type: string
+        description: Why this level was set
+
+    # Timing
+    started_at:
+      type: datetime
+      description: When work started
+
+    completed_at:
+      type: datetime
+      description: When feature was completed
+
+    estimated_complexity:
+      type: string
+      enum: [trivial, low, medium, high, very_high]
+      description: Complexity estimate
+
+# Example feature structure
+example:
+  id: user_authentication
+  name: User Authentication
+  description: Allow users to register, login, and manage sessions
+  priority: p0
+  category: auth
+  phase: backend
+  dependencies: []
+
+  implementation:
+    approach: JWT-based auth with refresh tokens
+    files:
+      - src/services/auth.service.ts
+      - src/controllers/auth.controller.ts
+      - src/middleware/auth.middleware.ts
+      - src/utils/jwt.ts
+    models:
+      - User
+      - RefreshToken
+    apis:
+      - POST /auth/register
+      - POST /auth/login
+      - POST /auth/refresh
+      - POST /auth/logout
+    components:
+      - LoginForm
+      - RegisterForm
+
+  testing:
+    unit_tests:
+      - auth.service.test.ts
+      - jwt.test.ts
+    integration_tests:
+      - auth.routes.test.ts
+    acceptance_criteria:
+      - Users can register with email and password
+      - Users can login and receive JWT token
+      - Invalid credentials return appropriate error
+      - Tokens expire after configured time
+
+  status: pending
+  progress:
+    steps_total: 7
+    steps_completed: 0
+    tests_total: 12
+    tests_passed: 0
+
+  autonomy:
+    level: 2
+    reason: Auth is security-critical
+
+  estimated_complexity: medium
+
+# Feature extraction rules
+extraction_rules:
+  from_prd:
+    - section: "Core Features"
+      priority: p0
+    - section: "Additional Features"
+      priority: p1
+    - section: "Future Considerations"
+      priority: p2
+
+  auto_categorize:
+    auth:
+      keywords: [login, register, authentication, password, session, jwt, oauth]
+    data:
+      keywords: [database, model, schema, crud, query]
+    ui:
+      keywords: [page, component, form, button, modal, layout]
+    api:
+      keywords: [endpoint, route, rest, graphql, webhook]
+    integration:
+      keywords: [stripe, email, sms, third-party, external]
+    infrastructure:
+      keywords: [deploy, ci, docker, kubernetes, monitoring]

package/plugin/templates/autonomous/memory-system.yaml

@@ -0,0 +1,298 @@
+# Memory System for Autonomous Development
+# Defines how context is preserved across sessions
+
+version: 1
+
+# Memory structure
+structure:
+  base_path: ".omgkit/memory"
+
+  directories:
+    context:
+      path: "context/"
+      description: "Current project context files"
+      retention: "persistent"
+
+    decisions:
+      path: "decisions/"
+      description: "Decision records and ADRs"
+      retention: "persistent"
+
+    journal:
+      path: "journal/"
+      description: "Daily development logs"
+      retention: "30_days"
+
+    patterns:
+      path: "patterns/"
+      description: "Learned patterns and preferences"
+      retention: "persistent"
+
+    cache:
+      path: "cache/"
+      description: "Temporary cached data"
+      retention: "session"
+
+# Context files
+context_files:
+  - id: project_brief
+    filename: "project-brief.md"
+    description: "High-level project overview"
+    update_frequency: "on_discovery_complete"
+    template: |
+      # {project_name}
+
+      ## Overview
+      {description}
+
+      ## Type
+      {project_type}
+
+      ## Key Features
+      {features_summary}
+
+      ## Tech Stack
+      {tech_stack}
+
+      ## Status
+      Current Phase: {current_phase}
+      Last Updated: {timestamp}
+
+  - id: current_feature
+    filename: "current-feature.md"
+    description: "Details of feature being implemented"
+    update_frequency: "on_feature_start"
+    template: |
+      # Current Feature: {feature_name}
+
+      ## Description
+      {description}
+
+      ## Acceptance Criteria
+      {acceptance_criteria}
+
+      ## Implementation Plan
+      {implementation_steps}
+
+      ## Progress
+      Steps Completed: {completed}/{total}
+
+      ## Notes
+      {notes}
+
+  - id: tech_decisions
+    filename: "tech-decisions.md"
+    description: "Summary of technical decisions"
+    update_frequency: "on_decision"
+    template: |
+      # Technical Decisions
+
+      ## Stack
+      - Frontend: {frontend}
+      - Backend: {backend}
+      - Database: {database}
+      - Hosting: {hosting}
+
+      ## Key Decisions
+      {decisions_list}
+
+      ## Patterns Used
+      {patterns_list}
+
+  - id: error_context
+    filename: "error-context.md"
+    description: "Context for error recovery"
+    update_frequency: "on_error"
+    template: |
+      # Error Context
+
+      ## Last Error
+      {error_message}
+
+      ## Location
+      File: {file}
+      Line: {line}
+
+      ## Attempted Fixes
+      {fixes_attempted}
+
+      ## Resolution Status
+      {status}
+
+# Decision record template
+decision_template:
+  filename_pattern: "{date}-{id}.md"
+  template: |
+    # Decision: {title}
+
+    **Date:** {date}
+    **Status:** {status}
+    **Phase:** {phase}
+
+    ## Context
+    {context}
+
+    ## Decision
+    {decision}
+
+    ## Options Considered
+    {options}
+
+    ## Rationale
+    {rationale}
+
+    ## Consequences
+    {consequences}
+
+    ## Related
+    - Features: {related_features}
+    - Files: {related_files}
+
+# Journal entry template
+journal_template:
+  filename_pattern: "{date}.md"
+  template: |
+    # Development Journal - {date}
+
+    ## Session Summary
+    Started: {start_time}
+    Ended: {end_time}
+
+    ## Work Completed
+    {completed_items}
+
+    ## In Progress
+    {in_progress_items}
+
+    ## Decisions Made
+    {decisions}
+
+    ## Challenges
+    {challenges}
+
+    ## Notes
+    {notes}
+
+    ## Tomorrow
+    {next_steps}
+
+# Pattern recognition
+patterns:
+  capture:
+    - trigger: "similar_code_structure"
+      action: "record_pattern"
+      template: |
+        ## Pattern: {name}
+
+        ### Context
+        When to use: {when}
+
+        ### Structure
+        ```{language}
+        {code_structure}
+        ```
+
+        ### Examples
+        {examples}
+
+  apply:
+    - trigger: "similar_task"
+      action: "suggest_pattern"
+      threshold: 0.8  # Similarity threshold
+
+# Memory operations
+operations:
+  read:
+    - Load relevant context files
+    - Check for recent decisions
+    - Load patterns for current task
+    - Check error context if resuming
+
+  write:
+    - Update context files atomically
+    - Create decision records
+    - Append to journal
+    - Update patterns if learned
+
+  cleanup:
+    - Archive old journal entries
+    - Compress old decisions
+    - Clear session cache
+    - Maintain size limits
+
+# Memory limits
+limits:
+  max_context_files: 10
+  max_context_file_size: "50KB"
+  max_decisions_kept: 100
+  max_journal_entries: 30
+  max_patterns: 50
+  total_memory_size: "10MB"
+
+# Session handling
+session:
+  start:
+    - Load project-brief.md
+    - Load current-feature.md if exists
+    - Load recent decisions
+    - Load relevant patterns
+    - Check for error context
+
+  during:
+    - Update current-feature.md on progress
+    - Record decisions as they happen
+    - Append to journal periodically
+    - Cache intermediate state
+
+  end:
+    - Save final state
+    - Complete journal entry
+    - Clean session cache
+    - Archive if needed
+
+# Context prioritization
+prioritization:
+  always_load:
+    - project-brief.md
+    - tech-decisions.md
+
+  load_if_relevant:
+    - current-feature.md
+    - error-context.md
+
+  load_on_demand:
+    - Decision records
+    - Patterns
+
+# Retrieval settings
+retrieval:
+  search:
+    - Index context files
+    - Search by keywords
+    - Filter by date range
+    - Sort by relevance
+
+  relevance_factors:
+    - Recency: 0.3
+    - Keyword match: 0.4
+    - Phase match: 0.2
+    - Category match: 0.1
+
+# Export/import
+export:
+  format: "zip"
+  includes:
+    - All context files
+    - All decisions
+    - Recent journal entries
+    - Active patterns
+  excludes:
+    - Cache
+    - Temporary files
+
+import:
+  validation:
+    - Check structure
+    - Validate schemas
+    - Check for conflicts
+  merge_strategy: "newer_wins"