contextos-agents 1.6.1 → 2.0.0-beta.2

package/package.json

@@ -1,75 +1,87 @@
 {
-  "name": "contextos-agents",
-  "version": "1.6.1",
-  "description": "Install a .agents folder into your project to teach AI assistants best practices: UI/UX, architecture, security, and engineering workflow skills.",
-  "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/mcp",
-    "benchmarks/gemini-issues.js"
-  ],
-  "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/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",
-    "prepublishOnly": "npm run validate && cd contextos-mcp && npm install && npm run build:bundle && cd .. && 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

@@ -12,7 +12,9 @@
       "npm": null,
       "github": "kok-o/contextos-agents",
       "path": ".agents/core/skills/ponytail-mindset",
-      "builtin": true
+      "builtin": true,
+      "type": "instruction-only",
+      "resources": ["EXAMPLES.md", "SKILL.md", "TROUBLESHOOTING.md", "VALIDATION.json"]
     },
     {
       "id": "koko-o/gstack-roles",
@@ -23,7 +25,9 @@
       "npm": null,
       "github": "kok-o/contextos-agents",
       "path": ".agents/core/skills/gstack-roles",
-      "builtin": true
+      "builtin": true,
+      "type": "instruction-only",
+      "resources": ["EXAMPLES.md", "SKILL.md", "TROUBLESHOOTING.md", "VALIDATION.json"]
     },
     {
       "id": "koko-o/impeccable-design",
@@ -33,19 +37,23 @@
       "tags": ["ui", "design", "frontend", "anti-patterns"],
       "npm": null,
       "github": "kok-o/contextos-agents",
-      "path": ".agents/core/skills/impeccable-design",
-      "builtin": true
+      "path": "catalog/skills/impeccable-design",
+      "builtin": true,
+      "type": "instruction-only",
+      "resources": ["EXAMPLES.md", "SKILL.md", "TROUBLESHOOTING.md", "VALIDATION.json"]
     },
     {
       "id": "koko-o/graphify",
       "name": "graphify",
-      "description": "Codebase knowledge graph generator via Tree-sitter AST parsing and semantic indexing.",
+      "description": "Codebase knowledge graph generator and architecture mapping guide. Instructs agents on AST dependency extraction and blast radius analysis.",
       "author": "koko-o",
       "tags": ["knowledge-graph", "ast", "tree-sitter", "dependencies", "architecture"],
       "npm": null,
       "github": "kok-o/contextos-agents",
-      "path": ".agents/core/skills/graphify",
-      "builtin": true
+      "path": "catalog/skills/graphify",
+      "builtin": true,
+      "type": "instruction-only",
+      "resources": ["EXAMPLES.md", "SKILL.md", "VALIDATION.json"]
     }
   ],
   "contributing": "https://github.com/kok-o/contextos-agents/blob/main/CONTRIBUTING.md#publishing-a-skill-as-a-plugin",

package/registry.schema.json

@@ -25,7 +25,9 @@
         "npm":         { "type": ["string", "null"], "description": "npm package name if published" },
         "github":      { "type": ["string", "null"], "description": "GitHub repo in owner/repo format" },
         "path":        { "type": ["string", "null"], "description": "Path within the GitHub repo to the skill directory" },
-        "builtin":     { "type": "boolean", "description": "true = ships with contextos-agents core" }
+        "builtin":     { "type": "boolean", "description": "true = ships with contextos-agents core" },
+        "type":        { "type": "string", "enum": ["instruction-only", "compiler", "runtime", "experimental"], "description": "Skill capability model" },
+        "resources":   { "type": "array", "items": { "type": "string" }, "description": "Explicit manifest of files bundled with this skill" }
       }
     }
   }

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
-```