@kal-elsam/kairo-runtime 0.1.0

package/bin/harness.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { basename } from "node:path";
+import { runCli } from "../src/cli.js";
+
+const cliName = basename(process.argv[1] ?? "harness");
+
+runCli(process.argv.slice(2)).catch((error) => {
+  console.error(`${cliName}: ${error.message}`);
+  process.exitCode = 1;
+});

package/bin/kairo-runtime.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { basename } from "node:path";
+import { runCli } from "../src/cli.js";
+
+const cliName = basename(process.argv[1] ?? "kairo-runtime");
+
+runCli(process.argv.slice(2)).catch((error) => {
+  console.error(`${cliName}: ${error.message}`);
+  process.exitCode = 1;
+});

package/bin/kairo.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+import { basename } from "node:path";
+import { runCli } from "../src/cli.js";
+
+const cliName = basename(process.argv[1] ?? "kairo");
+
+runCli(process.argv.slice(2)).catch((error) => {
+  console.error(`${cliName}: ${error.message}`);
+  process.exitCode = 1;
+});

package/global-template/components/catalog.json

@@ -0,0 +1,25 @@
+{
+  "components": [
+    {
+      "id": "orchestrator",
+      "label": "Orchestrator",
+      "version": "1.0.0",
+      "defaultEnabled": true,
+      "assetFiles": ["orchestrator.md"],
+      "adapterHints": {}
+    },
+    {
+      "id": "sdd-core",
+      "label": "SDD Core",
+      "version": "1.0.0",
+      "defaultEnabled": true,
+      "assetFiles": ["workflow.md", "spec-sizing.md", "handoff.md"],
+      "adapterHints": {
+        "cursor": "- In repos with workspace harness: also read `.cursor/rules/` and `docs/specs/`.",
+        "codex": "- In repos with workspace harness: also read `.codex/skills/sdd/` when present.",
+        "claude": "- In repos with workspace harness: repo `AGENTS.md` wins over `CLAUDE.md` pointers.",
+        "opencode": "- In repos with workspace harness: also read `.opencode/` SDD assets when present."
+      }
+    }
+  ]
+}

package/global-template/components/orchestrator/orchestrator.md

@@ -0,0 +1,55 @@
+# Harness Orchestrator Contract
+
+> Managed by `@kal-elsam/harness` component `orchestrator`.
+
+## Role
+
+The Harness Orchestrator (conductor) coordinates work across local coding agents
+(Cursor, Codex, OpenCode, Claude). It does not replace any agent. It defines how
+agents hand off work and which source of truth governs.
+
+## Authority order
+
+```txt
+1. Current user instruction
+2. Repository AGENTS.md (when working inside a repo)
+3. Repository docs/ai/
+4. This orchestrator contract
+5. Agent-specific config
+```
+
+No agent is governance-primary. The repository governs when one exists.
+
+## Conductor loop
+
+```txt
+Intake → Classify → Spec (if needed) → Plan → Execute → Validate → Review → Human approval
+```
+
+Rules:
+
+- No autonomous loop without boundaries.
+- No repair loop without max attempts.
+- No critical change without human approval.
+- No success claim while the pipeline fails.
+
+## Handoff contract
+
+Every agent handing off work must state:
+
+- context read
+- files analyzed
+- decision taken
+- risks
+- suggested next action
+
+## Managed state
+
+```txt
+~/.harness/state.json       installed agents, components, backups
+~/.harness/components/      component contracts (orchestrator, sdd-core, ...)
+~/.harness/backups/         pre-change snapshots of agent configs
+```
+
+Run `harness doctor` to verify ecosystem health.
+Run `harness sync` to refresh managed content without touching user-owned sections.

package/global-template/components/sdd-core/handoff.md

@@ -0,0 +1,38 @@
+# Handoff Expectations
+
+> Managed by `@kal-elsam/harness` component `sdd-core`.
+
+Every agent handing off work must include:
+
+```txt
+context read
+files analyzed
+decision taken
+risks
+suggested next action
+```
+
+## Spec handoff
+
+When handing off after spec work, also include:
+
+```txt
+spec level (basic | standard | complex)
+spec path or summary
+open questions
+acceptance criteria
+validation plan
+```
+
+## Implementation handoff
+
+When handing off after implementation, also include:
+
+```txt
+tests run
+pipeline status
+remaining risks
+rollback notes
+```
+
+Human approval is required for critical or architectural impact.

package/global-template/components/sdd-core/spec-sizing.md

@@ -0,0 +1,38 @@
+# Spec Sizing Rules
+
+> Managed by `@kal-elsam/harness` component `sdd-core`.
+
+## Levels
+
+```txt
+basic    → low-risk, localized, well-understood work
+standard → normal product/engineering changes
+complex  → architecture, security, data, AI behavior, or high blast radius
+```
+
+## Classification heuristics
+
+```txt
+0-3 points → basic
+4-7 points → standard
+8+ points  → complex
+```
+
+Score upward when the task touches architecture, API contracts, database schema,
+auth/security, payments, AI behavior, migrations, or multiple modules.
+
+## Anti-patterns
+
+```txt
+Over-specification: complex SDD for a one-line copy change.
+Under-specification: basic spec for auth, billing, or schema migrations.
+```
+
+## Escalation triggers
+
+Upgrade the spec level when:
+
+- scope grows after planning
+- new integrations appear
+- rollback is non-trivial
+- tests cannot be defined clearly at the current level

package/global-template/components/sdd-core/workflow.md

@@ -0,0 +1,31 @@
+# SDD Workflow Contract
+
+> Managed by `@kal-elsam/harness` component `sdd-core`.
+
+## Workflow
+
+Every non-trivial change follows:
+
+```txt
+Requirement → Classify → Spec → Plan → Tests failing first → Implement → Validate → Review → Human approval
+```
+
+## Rules
+
+- No significant feature without a spec.
+- No bug fix without a regression test that fails first.
+- No success claim while the pipeline fails.
+- Escalate spec level when risk, ambiguity, or blast radius increases.
+- Inside a repository, repo `AGENTS.md` and `docs/ai/` govern over this global contract.
+
+## Repository override
+
+When working inside a project with harness workspace assets, prefer:
+
+```txt
+docs/ai/spec-driven-development.md
+docs/ai/spec-sizing.md
+docs/specs/
+```
+
+This global contract is the fallback when no repository harness is present.

package/global-template/core/orchestrator.md

@@ -0,0 +1,55 @@
+# Harness Orchestrator Contract
+
+> Managed by `@kal-elsam/harness`. Source of truth for cross-agent orchestration.
+
+## Role
+
+The Harness Orchestrator (conductor) coordinates work across local coding agents
+(Cursor, Codex, OpenCode, Claude). It does not replace any agent. It defines how
+agents hand off work and which source of truth governs.
+
+## Authority order
+
+```txt
+1. Current user instruction
+2. Repository AGENTS.md (when working inside a repo)
+3. Repository docs/ai/
+4. This orchestrator contract
+5. Agent-specific config
+```
+
+No agent is governance-primary. The repository governs when one exists.
+
+## Conductor loop
+
+```txt
+Intake → Classify → Spec (if needed) → Plan → Execute → Validate → Review → Human approval
+```
+
+Rules:
+
+- No autonomous loop without boundaries.
+- No repair loop without max attempts.
+- No critical change without human approval.
+- No success claim while the pipeline fails.
+
+## Handoff contract
+
+Every agent handing off work must state:
+
+- context read
+- files analyzed
+- decision taken
+- risks
+- suggested next action
+
+## Managed state
+
+```txt
+~/.harness/state.json    installed agents, core files, backups
+~/.harness/core/         orchestrator/core contracts (this file)
+~/.harness/backups/      pre-change snapshots of agent configs
+```
+
+Run `harness doctor` to verify ecosystem health.
+Run `harness sync` to refresh managed content without touching user-owned sections.

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@kal-elsam/kairo-runtime",
+  "version": "0.1.0",
+  "description": "Kairo Runtime — local agent operating system for Codex, Cursor, Claude, Gemini, Copilot, Engram, and Graphify.",
+  "type": "module",
+  "homepage": "https://github.com/Kal-elSam/harness#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kal-elSam/harness.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Kal-elSam/harness/issues"
+  },
+  "bin": {
+    "kairo": "./bin/kairo.js",
+    "kairo-runtime": "./bin/kairo-runtime.js",
+    "harness": "./bin/harness.js",
+    "agentic-harness": "./bin/harness.js",
+    "sgs-harness": "./bin/harness.js",
+    "harness-sgs": "./bin/harness.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "scripts",
+    "repo-template",
+    "global-template",
+    "prompts",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "doctor": "node ./bin/kairo.js doctor",
+    "smoke": "bash scripts/smoke-test.sh",
+    "ux:smoke": "bash scripts/ux-smoke-test.sh",
+    "smoke:registry": "bash scripts/registry-smoke-test.sh",
+    "smoke:installer": "bash scripts/installer-smoke-test.sh",
+    "release:check": "node scripts/check-release-commit.mjs",
+    "release:published": "node scripts/check-published-release.mjs"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "codex",
+    "cursor",
+    "kairo",
+    "kairo-runtime",
+    "harness",
+    "sdd",
+    "tdd"
+  ],
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.12.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.7.0",
+    "ink": "^5.2.1",
+    "react": "^18.3.1"
+  }
+}

package/prompts/HARNESS_ENFORCEMENT_UPGRADE.md

@@ -0,0 +1,11 @@
+# Harness Enforcement Upgrade
+
+Use this prompt to upgrade an existing harness from methodology-first to enforcement-first.
+
+## Goal
+
+Add executable quality controls, trust policy, evals and lifecycle automation.
+
+## Rule
+
+Do not overwrite existing project-specific CI without merging. Keep adapters as translation layers and `AGENTS.md` as governance-primary.

package/prompts/HARNESS_ENTERPRISE.md

@@ -0,0 +1,33 @@
+# Harness Installer — Enterprise Mode
+
+Instala un harness enterprise para productos serios, IA, agentes, DB, API, auth, colas o integraciones externas.
+
+Crea:
+
+```txt
+AGENTS.md
+AGENT.md
+docs/ai/
+docs/skills/
+docs/specs/
+evals/
+.cursor/rules/
+.cursor/commands/
+.cursor/agents/
+.cursor/skills/
+setup-agent-links.sh
+```
+
+Debe incluir SDD, TDD, AI evals, context budget, security, memory, context graph, Gentle AI, Engram y Graphify.
+
+Flujo obligatorio:
+
+```txt
+INTAKE → SPEC → PLAN → TEST_FIRST → IMPLEMENT → VALIDATE → REVIEW → APPROVAL → CHECKPOINT
+```
+
+Para sistemas IA:
+
+```txt
+Spec + Tests + Evals + Observability
+```