contextos-agents 1.7.0 → 2.0.0-beta.2

package/package.json

@@ -1,74 +1,87 @@
 {
-  "name": "contextos-agents",
-  "version": "1.7.0",
-  "description": "ContextOS — Deterministic context compiler, MCP runtime, and high-precision agent skills for pair-programming.",
-  "bin": {
-    "contextos": "./bin/index.js",
-    "contextos-agents": "./bin/index.js",
-    "koko-contextos-agents": "./bin/index.js"
-  },
-  "files": [
-    "bin",
-    "registry.json",
-    "registry.schema.json",
-    ".agents/AGENTS.md",
-    ".agents/skills.json",
-    ".agents/ctx.js",
-    ".agents/validate.js",
-    ".agents/plugins.js",
-    ".agents/profiles.js",
-    ".agents/resolver.js",
-    ".agents/doctor.js",
-    ".agents/stats.js",
-    ".agents/watch.js",
-    ".agents/skills-index.json",
-    ".agents/adapters",
-    ".agents/core",
-    ".agents/generated",
-    ".agents/plugins/contextos"
-  ],
-  "scripts": {
-    "build": "node .agents/ctx.js export all",
-    "export": "node .agents/ctx.js export gemini",
-    "validate": "node .agents/ctx.js validate",
-    "benchmark": "node benchmarks/gemini-issues.js",
-    "benchmark:live": "node benchmarks/run-live-benchmark.js",
-    "benchmark:runtime": "node benchmarks/run-runtime-benchmark.js",
-    "lint:md": "markdownlint README.md CONTRIBUTING.md .agents/core/skills/**/*.md --ignore .agents/generated/** --config .markdownlint.json",
-    "check:secrets": "node scripts/check-secrets.js --all",
-    "setup:hooks": "node scripts/install-hooks.js",
-    "watch": "node .agents/watch.js",
-    "test": "node --test --test-concurrency=1 tests/install.test.js tests/lockfile.test.js tests/safe-writer.test.js tests/adapter-safety.test.js tests/update.test.js tests/uninstall.test.js tests/plugin-security.test.js tests/export.test.js tests/skills.test.js tests/validate.test.js tests/plugins.test.js tests/benchmark.test.js tests/profile.test.js tests/resolver.test.js tests/cli-registry.test.js tests/profile-enforcement.test.js tests/doctor-hardening.test.js",
-    "prepublishOnly": "cd contextos-mcp && npm install && npm run build && npm run build:root-sync && cd .. && npm run validate && npm run build"
-  },
-  "keywords": [
-    "ai",
-    "agents",
-    "contextos",
-    "ai-agents",
-    "claude",
-    "gemini",
-    "cursor",
-    "llm",
-    "prompt-engineering",
-    "skills",
-    "coding-assistant"
-  ],
-  "author": "koko-o",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/kok-o/contextos-agents.git"
-  },
-  "homepage": "https://github.com/kok-o/contextos-agents#readme",
-  "bugs": {
-    "url": "https://github.com/kok-o/contextos-agents/issues"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "devDependencies": {
-    "markdownlint-cli": "^0.43.0"
-  },
-  "dependencies": {}
+    "name": "contextos-agents",
+    "version": "2.0.0-beta.2",
+    "description": "ContextOS — Deterministic context compiler and policy engine for AI agents.",
+    "bin": {
+        "contextos": "./bin/index.js",
+        "contextos-agents": "./bin/index.js",
+        "koko-contextos-agents": "./bin/index.js"
+    },
+    "files": [
+        "bin",
+        "registry.json",
+        "registry.schema.json",
+        "registry.v2.schema.json",
+        ".agents/AGENTS.md",
+        ".agents/skills.json",
+        ".agents/ctx.js",
+        ".agents/validate.js",
+        ".agents/plugins.js",
+        ".agents/profiles.js",
+        ".agents/resolver.js",
+        ".agents/doctor.js",
+        ".agents/stats.js",
+        ".agents/watch.js",
+        ".agents/skills-index.json",
+        ".agents/adapters",
+        ".agents/core",
+        ".agents/generated",
+        ".agents/plugins/contextos",
+        ".agents/compiled",
+        ".agents/compiler",
+        ".agents/schemas",
+        ".agents/workspace",
+        ".agents/filesystem",
+        ".agents/transaction-core",
+        ".agents/customization-dx.js",
+        "benchmarks/v2"
+    ],
+    "scripts": {
+        "build": "node .agents/ctx.js compile && node .agents/ctx.js export all",
+        "compile": "node .agents/ctx.js compile",
+        "export": "node .agents/ctx.js export gemini",
+        "validate": "node .agents/ctx.js validate",
+        "benchmark": "node benchmarks/gemini-issues.js",
+        "benchmark:live": "node benchmarks/run-live-benchmark.js",
+        "benchmark:runtime": "node benchmarks/run-runtime-benchmark.js",
+        "lint:md": "markdownlint README.md CONTRIBUTING.md .agents/core/skills/**/*.md --ignore .agents/generated/** --config .markdownlint.json",
+        "check:secrets": "node scripts/check-secrets.js --all",
+        "setup:hooks": "node scripts/install-hooks.js",
+        "watch": "node .agents/watch.js",
+        "test": "node --test --test-concurrency=1 tests/install.test.js tests/lockfile.test.js tests/safe-writer.test.js tests/adapter-safety.test.js tests/update.test.js tests/uninstall.test.js tests/plugin-security.test.js tests/export.test.js tests/skills.test.js tests/validate.test.js tests/plugins.test.js tests/benchmark.test.js tests/profile.test.js tests/resolver.test.js tests/cli-registry.test.js tests/profile-enforcement.test.js tests/doctor-hardening.test.js tests/manifest-compiler.test.js tests/canonical-resolver.test.js tests/workspace-graph.test.js tests/profiles-v2.test.js tests/safe-path.test.js tests/project-lock.test.js tests/journaled-transaction.test.js tests/pure-adapters.test.js tests/prompt-skill-system.test.js tests/runtime-state-machine.test.js tests/verification-reviewer-pipeline.test.js tests/durable-concurrency-locks.test.js tests/transactional-git.test.js tests/sandbox-execution.test.js tests/plugin-supply-chain.test.js tests/platform-hardening.test.js tests/customization-dx.test.js tests/claims-governance.test.js tests/benchmark-v2.test.js tests/init-engine.test.js tests/mutation-paths.test.js",
+        "prepublishOnly": "npm run validate && npm run build"
+    },
+    "keywords": [
+        "context-compiler",
+        "context-governance",
+        "policy-as-code",
+        "ai-agents",
+        "coding-agents",
+        "developer-tools",
+        "cursor",
+        "claude-code",
+        "github-copilot",
+        "gemini",
+        "zed",
+        "mcp",
+        "contextos"
+    ],
+    "author": "koko-o",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/kok-o/contextos-agents.git"
+    },
+    "homepage": "https://github.com/kok-o/contextos-agents#readme",
+    "bugs": {
+        "url": "https://github.com/kok-o/contextos-agents/issues"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "devDependencies": {
+        "esbuild": "^0.28.2",
+        "markdownlint-cli": "^0.43.0",
+        "yaml": "^2.9.0"
+    }
 }

package/registry.json

@@ -37,7 +37,7 @@
       "tags": ["ui", "design", "frontend", "anti-patterns"],
       "npm": null,
       "github": "kok-o/contextos-agents",
-      "path": ".agents/core/skills/impeccable-design",
+      "path": "catalog/skills/impeccable-design",
       "builtin": true,
       "type": "instruction-only",
       "resources": ["EXAMPLES.md", "SKILL.md", "TROUBLESHOOTING.md", "VALIDATION.json"]
@@ -50,7 +50,7 @@
       "tags": ["knowledge-graph", "ast", "tree-sitter", "dependencies", "architecture"],
       "npm": null,
       "github": "kok-o/contextos-agents",
-      "path": ".agents/core/skills/graphify",
+      "path": "catalog/skills/graphify",
       "builtin": true,
       "type": "instruction-only",
       "resources": ["EXAMPLES.md", "SKILL.md", "VALIDATION.json"]

package/registry.v2.schema.json

@@ -0,0 +1,86 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "CompiledRegistryV2",
+  "description": "ContextOS Compiled Registry v2 Schema",
+  "type": "object",
+  "required": [
+    "schemaVersion",
+    "compilerVersion",
+    "sourceGraphHash",
+    "generatedAt",
+    "skills"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": {
+      "type": "integer",
+      "const": 2
+    },
+    "compilerVersion": {
+      "type": "string"
+    },
+    "sourceGraphHash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "generatedAt": {
+      "type": "string"
+    },
+    "skills": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "object",
+        "required": [
+          "id",
+          "displayName",
+          "version",
+          "entrypoint",
+          "entrypointHash",
+          "resourceTreeHash",
+          "estimatedTokens",
+          "source",
+          "dependencies"
+        ],
+        "properties": {
+          "id": { "type": "string" },
+          "displayName": { "type": "string" },
+          "version": { "type": "string" },
+          "description": { "type": "string" },
+          "category": { "type": "string" },
+          "type": { "type": "string" },
+          "entrypoint": { "type": "string" },
+          "entrypointHash": { "type": "string" },
+          "resourceTreeHash": { "type": "string" },
+          "estimatedTokens": { "type": "integer" },
+          "source": { "type": "string" },
+          "signals": { "type": "object" },
+          "dependencies": {
+            "type": "object",
+            "properties": {
+              "requires": { "type": "array", "items": { "type": "string" } },
+              "optional": { "type": "array", "items": { "type": "string" } },
+              "conflicts": { "type": "array", "items": { "type": "string" } }
+            }
+          },
+          "context": { "type": "object" },
+          "resources": { "type": "array" }
+        }
+      }
+    },
+    "aliases": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    },
+    "packageMap": {
+      "type": "object",
+      "additionalProperties": { "type": "string" }
+    },
+    "dependencyGraph": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string" }
+      }
+    }
+  }
+}

package/.agents/core/profiles/backend.yaml

@@ -1,47 +0,0 @@
-# Profile: Backend
-# Dedicated backend & API architecture focus
-
-id: backend
-name: Backend
-description: "Specialized for server-side architectures, APIs, databases, microservices, and system design."
-
-generate_docs:
-  - PRD
-  - ARCHITECTURE
-  - DATABASE
-  - API
-  - TASKS
-
-skip_docs:
-  - UI
-
-prefer_skills:
-  - system-design
-  - node
-  - fastapi
-  - nestjs
-  - microservices
-  - ddd
-  - security
-  - performance
-  - decisions
-  - engineering-workflow
-  - ponytail-mindset
-
-exclude_skills:
-  - ui-ux-pro
-  - impeccable-design
-  - ui-design
-  - ux-design
-  - web-accessibility
-
-enforce:
-  adr: true
-  testing: true
-  security_audit: true
-  code_review: true
-
-defaults:
-  architecture: modular-monolith-or-microservices
-  database: postgresql
-  auth: jwt

package/.agents/core/profiles/enterprise.yaml

@@ -1,46 +0,0 @@
-# Profile: Enterprise
-# Maximum rigor and documentation
-
-id: enterprise
-name: Enterprise
-description: "Full documentation, DDD, ADR, security audits, comprehensive testing."
-
-generate_docs:
-  - PRD
-  - ARCHITECTURE
-  - DATABASE
-  - API
-  - UI
-  - ROADMAP
-  - TASKS
-  - PROJECT_GRAPH
-  - DEPLOYMENT
-
-skip_docs: []  # Generate everything
-
-prefer_skills:
-  - postgres
-  - redis
-  - docker
-  - ddd
-  - microservices
-  - security
-
-exclude_skills: []  # Nothing excluded
-
-enforce:
-  adr: true                # Every decision must be recorded
-  testing: true             # Tests required, min coverage 80%
-  security_audit: true      # OWASP check on every PR
-  code_review: true         # Mandatory review
-  accessibility_audit: true # WCAG 2.1 AA compliance
-
-defaults:
-  architecture: microservices  # or modular-monolith
-  database: postgresql
-  auth: oauth2-jwt
-  hosting: kubernetes
-  orm: typeorm  # or prisma
-  monitoring: prometheus-grafana
-  logging: elk-stack
-  ci_cd: github-actions

package/.agents/core/profiles/frontend.yaml

@@ -1,46 +0,0 @@
-# Profile: Frontend
-# Dedicated frontend stack focus
-
-id: frontend
-name: Frontend
-description: "Specialized for modern frontend applications (React, Next.js, UI/UX, Design Systems, Accessibility)."
-
-generate_docs:
-  - PRD
-  - UI
-  - TASKS
-
-skip_docs:
-  - DATABASE
-  - MICROSERVICES
-
-prefer_skills:
-  - react
-  - nextjs
-  - typescript
-  - ui-ux-pro
-  - impeccable-design
-  - ui-design
-  - ux-design
-  - web-accessibility
-  - ponytail-mindset
-  - engineering-workflow
-  - gstack-roles
-
-exclude_skills:
-  - fastapi
-  - nestjs
-  - microservices
-  - ddd
-
-enforce:
-  adr: false
-  testing: true
-  accessibility_audit: true
-  code_review: true
-
-defaults:
-  architecture: frontend-spa-or-ssr
-  framework: nextjs
-  styling: tailwind-or-css
-  state: react-state

package/.agents/core/profiles/hackathon.yaml

@@ -1,45 +0,0 @@
-# Profile: Hackathon
-# 24-48 hours to ship something impressive
-
-id: hackathon
-name: Hackathon
-description: "Ship something impressive in 24-48 hours. No ceremony, just build."
-
-generate_docs:
-  - TASKS          # What to build, in order
-  - PROJECT_GRAPH  # Quick module map
-
-skip_docs:
-  - PRD
-  - ARCHITECTURE
-  - DATABASE
-  - API
-  - UI
-  - ROADMAP
-  - DEPLOYMENT
-
-prefer_skills:
-  - sqlite
-  - react
-  - typescript
-
-exclude_skills:
-  - ddd
-  - microservices
-  - kubernetes
-  - monitoring
-  - cicd
-  - security  # Sorry, security — not today
-  - testing   # Sorry, tests — not today
-
-enforce:
-  adr: false
-  testing: false
-  security_audit: false
-  code_review: false
-
-defaults:
-  architecture: single-file  # or monolith
-  database: sqlite
-  auth: none  # or simple-jwt
-  hosting: vercel

package/.agents/core/profiles/mvp.yaml

@@ -1,44 +0,0 @@
-# Profile: MVP
-# Minimum viable product — speed is everything
-
-id: mvp
-name: MVP
-description: "Ship the fastest possible working version. Cut everything non-essential."
-
-generate_docs:
-  - PRD        # Must know what to build
-  - TASKS      # Must know task order
-  - PROJECT_GRAPH  # Must know module structure
-
-skip_docs:
-  - ARCHITECTURE   # Keep it simple, decide as you go
-  - DATABASE       # Schema emerges from code (Prisma/SQLAlchemy)
-  - API            # API emerges from implementation
-  - UI             # Build directly, iterate fast
-  - ROADMAP        # No long-term planning yet
-  - DEPLOYMENT     # Deploy later
-
-prefer_skills:
-  - sqlite        # Simplest database
-  - simple-auth   # Minimal auth (email + password)
-
-exclude_skills:
-  - ddd
-  - microservices
-  - system-design
-  - kubernetes
-  - monitoring
-  - cicd
-  - cqrs
-
-enforce:
-  adr: false
-  testing: false        # Tests are nice, but not blocking
-  security_audit: false
-  code_review: false
-
-defaults:
-  architecture: monolith
-  database: sqlite
-  auth: simple-jwt
-  hosting: vercel

package/.agents/core/profiles/startup.yaml

@@ -1,48 +0,0 @@
-# Profile: Startup
-# Balanced between speed and quality
-
-id: startup
-name: Startup
-description: "Fast iteration with reasonable quality. Ship early, learn fast."
-
-# What to generate
-generate_docs:
-  - PRD
-  - ARCHITECTURE
-  - DATABASE
-  - API
-  - UI
-  - TASKS
-  - PROJECT_GRAPH
-
-# What to skip
-skip_docs:
-  - ROADMAP  # Optional — generate on request
-  - DEPLOYMENT  # Handle later
-
-# Skill preferences
-prefer_skills:
-  - postgres
-  - redis
-  - docker
-  - jwt
-
-exclude_skills:
-  - kubernetes
-  - ddd
-  - microservices
-
-# Quality gates
-enforce:
-  adr: false            # Record decisions, but don't block on it
-  testing: true          # Tests required
-  security_audit: false  # Not mandatory at this stage
-  code_review: true      # Self-review
-
-# Architecture defaults
-defaults:
-  architecture: modular-monolith
-  database: postgresql
-  auth: jwt
-  hosting: vercel-railway
-  orm: prisma

package/.agents/core/skills/adapters/EXAMPLES.md

@@ -1,19 +0,0 @@
-# adapters Examples — Anti-patterns vs ContextOS Standard
-
-## Example 1: Multi-Agent Configuration
-
-### Anti-pattern: Manually Syncing 6 Different Rule Files
-
-```text
-Editing .cursorrules, then forgetting to update CLAUDE.md, then editing copilot-instructions.md.
-Rules diverge across teammates using different IDEs.
-```
-
-### Best practice: ContextOS Standard (Single Source of Truth)
-
-```bash
-# Edit skills once in .agents/core/skills/
-# Compile to all agents with one command:
-node .agents/ctx.js export all
-# Automatically updates .cursorrules, CLAUDE.md, copilot-instructions.md, .aider, .zed
-```

package/.agents/core/skills/adapters/SKILL.md

@@ -1,105 +0,0 @@
----
-name: adapters
-description: >
-  Generates agent-specific configuration files from the unified ContextOS format.
-  One internal system, multiple output formats for Claude, Gemini, Copilot, 
-  Cursor, Aider, Continue, OpenHands, and others.
----
-
-# agent-adapters
-
-## Overview
-
-Unified cross-agent configuration engine. Translates single ContextOS source rules into optimized native formats for Claude Code (CLAUDE.md), Gemini (.agents/skills), Cursor (.cursorrules, .cursor/rules/*.mdc), GitHub Copilot, Zed, Aider, and Continue.
-
-## When to Use
-
-Activate when configuring, synchronizing, or exporting agent rules and skills across multiple IDEs and AI programming assistants.
-
-## Rules & Patterns
-
-ContextOS is agent-agnostic. This skill generates the right config format for any AI agent.
-
-## Supported Agents
-
-| Agent | Config File | Format |
-| --- | --- | --- |
-| **Gemini** | `.agents/AGENTS.md` + `.agents/skills/` | Markdown + YAML skills |
-| **Claude Code** | `CLAUDE.md` | Single markdown file |
-| **GitHub Copilot / Codex** | `AGENTS.md` (root) | Markdown |
-| **Cursor** | `.cursorrules` | Plain text rules |
-| **Aider** | `.aider.conf.yml` | YAML config |
-| **Continue** | `.continuerules` | Markdown rules |
-| **OpenHands** | `openhands.json` | JSON config |
-| **Roo Code** | `.roo/` | Directory with rules |
-| **Windsurf** | `.windsurfrules` | Plain text rules |
-
-## Generation Command
-
-`ctx adapt [agent]` — Generate config for a specific agent.
-
-`ctx adapt all` — Generate configs for all supported agents.
-
-## Adapter Logic
-
-### For Claude Code (`CLAUDE.md`)
-
-Compile into a single markdown file:
-
-1. Project overview from `docs/PRD.md` (summary only)
-2. Architecture summary from `docs/ARCHITECTURE.md`
-3. Coding rules from loaded skills
-4. Active Decision Records
-5. Current tasks from `docs/TASKS.md`
-
-### For Gemini (`.agents/AGENTS.md`)
-
-Already native format. Just ensure:
-
-1. `AGENTS.md` references the skill directory
-2. Skills have proper SKILL.md with frontmatter
-3. Context Manager rules are in AGENTS.md
-
-### For Cursor (`.cursorrules`)
-
-Compile into a flat text file:
-
-1. Project context (condensed)
-2. Coding style rules
-3. Framework-specific instructions
-4. Anti-patterns to avoid
-
-### For Aider (`.aider.conf.yml`)
-
-```yaml
-read:
-  - docs/ARCHITECTURE.md
-  - docs/API.md
-  - docs/PROJECT_GRAPH.md
-conventions:
-  - {{coding rules from skills}}
-```
-
-## Sync Rules
-
-- Adapters read from the canonical ContextOS documents
-- Never edit adapter output files directly
-- Re-run `ctx adapt` after any document change
-- Each adapter file includes a header: `# Generated by ContextOS — do not edit directly`
-
-
-## Code Examples
-
-See `EXAMPLES.md` for detailed code examples.
-
-## Validation Checklist
-
-What to verify during the review phase before completing the task.
-
-## Common Mistakes
-
-Anti-patterns and things to explicitly avoid. See `TROUBLESHOOTING.md`.
-
-## Integration Notes
-
-How this skill interacts with other skills.