@xn-intenton-z2a/agentic-lib 7.4.1 → 7.4.3

package/.github/workflows/agentic-lib-init.yml

@@ -27,7 +27,7 @@ on:
       mission-seed:
         type: string
         required: false
-        default: "hamming-distance"
+        default: "6-kyu-understand-hamming-distance"
       mission-text:
         type: string
         required: false
@@ -64,26 +64,26 @@ on:
         description: "Mission seed name (purge only)"
         type: choice
         required: false
-        default: "hamming-distance"
+        default: "6-kyu-understand-hamming-distance"
         options:
-          - hamming-distance
-          - agi
-          - ascii-face
-          - c64-emulator
-          - cron-engine
-          - dense-encoding
-          - fizz-buzz
-          - hello-world
-          - json-schema-diff
-          - lunar-lander
-          - markdown-compiler
-          - owl-ontology
-          - plot-code-lib
-          - ray-tracer
-          - roman-numerals
-          - string-utils
-          - time-series-lab
-          - empty
+          - 8-kyu-remember-empty
+          - 8-kyu-remember-hello-world
+          - 7-kyu-understand-fizz-buzz
+          - 6-kyu-understand-hamming-distance
+          - 6-kyu-understand-roman-numerals
+          - 5-kyu-create-ascii-face
+          - 5-kyu-apply-string-utils
+          - 4-kyu-apply-cron-engine
+          - 4-kyu-apply-dense-encoding
+          - 4-kyu-analyze-json-schema-diff
+          - 3-kyu-analyze-lunar-lander
+          - 3-kyu-evaluate-time-series-lab
+          - 3-kyu-evaluate-owl-ontology
+          - 2-kyu-evaluate-markdown-compiler
+          - 2-kyu-create-plot-code-lib
+          - 1-kyu-create-ray-tracer
+          - 1-dan-create-c64-emulator
+          - 2-dan-create-agi
       mission-text:
         description: "Freeform mission text for MISSION.md (overrides mission-seed if provided)"
         type: string
@@ -140,7 +140,7 @@ jobs:
     runs-on: ubuntu-latest
     env:
       INIT_MODE: ${{ inputs.mode }}
-      INIT_MISSION_SEED: ${{ inputs.mission-seed || 'hamming-distance' }}
+      INIT_MISSION_SEED: ${{ inputs.mission-seed || '6-kyu-understand-hamming-distance' }}
       INIT_MISSION_TEXT: ${{ inputs.mission-text }}
     steps:
       - uses: actions/checkout@v6

package/README.md

@@ -243,7 +243,7 @@ All task commands accept these flags:
 | `--dry-run` | off | Show the prompt without calling the Copilot SDK |
 | `--target <path>` | current directory | Target repository to transform |
 | `--model <name>` | `claude-sonnet-4` | Copilot SDK model |
-| `--mission <name>` | hamming-distance | Init with --purge before iterating (iterate only) |
+| `--mission <name>` | 6-kyu-understand-hamming-distance | Init with --purge before iterating (iterate only) |
 | `--timeout <ms>` | 600000 | Session timeout in milliseconds (iterate only) |
 
 ### Example: Full Walkthrough
@@ -303,18 +303,39 @@ The `iterate` command runs a single persistent Copilot SDK session that autonomo
 
 ```bash
 # Init a mission and iterate
-npx @xn-intenton-z2a/agentic-lib iterate --mission hamming-distance --model gpt-5-mini
+npx @xn-intenton-z2a/agentic-lib iterate --mission 6-kyu-understand-hamming-distance --model gpt-5-mini
 
 # Iterate on an existing workspace
 npx @xn-intenton-z2a/agentic-lib iterate --target /path/to/workspace
 
 # With a longer timeout (10 minutes)
-npx @xn-intenton-z2a/agentic-lib iterate --mission fizz-buzz --timeout 600000
+npx @xn-intenton-z2a/agentic-lib iterate --mission 7-kyu-understand-fizz-buzz --timeout 600000
 ```
 
 The session uses SDK hooks for observability (tool call tracking, error recovery) and infinite sessions for context management. The agent drives its own read-write-test loop until the mission is complete or the timeout is reached.
 
-**Available missions:** hamming-distance, fizz-buzz, roman-numerals, string-utils, cron-engine, dense-encoding, markdown-compiler, and more (see `src/seeds/missions/`).
+**Available missions** (see `src/seeds/missions/`). Mission names encode difficulty ([Codewars kyu/dan](https://docs.codewars.com/concepts/kata/)) and cognitive type ([Bloom's taxonomy](https://en.wikipedia.org/wiki/Bloom%27s_taxonomy)):
+
+| Mission | Kyu/Dan | Bloom's | Description |
+|---------|---------|---------|-------------|
+| `8-kyu-remember-empty` | 8 kyu | Remember | Blank template |
+| `8-kyu-remember-hello-world` | 8 kyu | Remember | Hello World |
+| `7-kyu-understand-fizz-buzz` | 7 kyu | Understand | Classic FizzBuzz |
+| `6-kyu-understand-hamming-distance` | 6 kyu | Understand | Hamming distance (strings + bits) |
+| `6-kyu-understand-roman-numerals` | 6 kyu | Understand | Roman numeral conversion |
+| `5-kyu-create-ascii-face` | 5 kyu | Create | ASCII face art |
+| `5-kyu-apply-string-utils` | 5 kyu | Apply | 10 string utility functions |
+| `4-kyu-apply-cron-engine` | 4 kyu | Apply | Cron expression parser |
+| `4-kyu-apply-dense-encoding` | 4 kyu | Apply | Dense binary encoding |
+| `4-kyu-analyze-json-schema-diff` | 4 kyu | Analyze | JSON Schema diff |
+| `3-kyu-analyze-lunar-lander` | 3 kyu | Analyze | Lunar lander simulation |
+| `3-kyu-evaluate-time-series-lab` | 3 kyu | Evaluate | Time series analysis |
+| `3-kyu-evaluate-owl-ontology` | 3 kyu | Evaluate | OWL ontology processor |
+| `2-kyu-evaluate-markdown-compiler` | 2 kyu | Evaluate | Markdown compiler |
+| `2-kyu-create-plot-code-lib` | 2 kyu | Create | Code visualization library |
+| `1-kyu-create-ray-tracer` | 1 kyu | Create | Ray tracer |
+| `1-dan-create-c64-emulator` | 1 dan | Create | C64 emulator |
+| `2-dan-create-agi` | 2 dan | Create | AGI vision |
 
 ### Running Local Benchmarks
 
@@ -338,28 +359,28 @@ source .env
 **Run a benchmark:**
 
 ```bash
-# Quick: hamming-distance with gpt-5-mini (simplest mission, ~1-2 min)
+# Quick: hamming-distance with gpt-5-mini (6 kyu, ~1-2 min)
 npx @xn-intenton-z2a/agentic-lib iterate \
-  --mission hamming-distance --model gpt-5-mini --timeout 300000
+  --mission 6-kyu-understand-hamming-distance --model gpt-5-mini --timeout 300000
 
 # Medium: roman-numerals with claude-sonnet-4
 npx @xn-intenton-z2a/agentic-lib iterate \
-  --mission roman-numerals --model claude-sonnet-4
+  --mission 6-kyu-understand-roman-numerals --model claude-sonnet-4
 
-# Complex: string-utils with gpt-4.1 (10 functions, longer timeout)
+# Complex: string-utils with gpt-4.1 (5 kyu, 10 functions, longer timeout)
 npx @xn-intenton-z2a/agentic-lib iterate \
-  --mission string-utils --model gpt-4.1 --timeout 600000
+  --mission 5-kyu-apply-string-utils --model gpt-4.1 --timeout 600000
 ```
 
 **From a local clone** (development):
 
 ```bash
 # From the agentic-lib directory
-npx . iterate --mission hamming-distance --model gpt-5-mini --target /tmp/bench
+npx . iterate --mission 6-kyu-understand-hamming-distance --model gpt-5-mini --target /tmp/bench
 
 # Or link globally
 npm link
-agentic-lib iterate --mission hamming-distance --model gpt-5-mini --target /tmp/bench
+agentic-lib iterate --mission 6-kyu-understand-hamming-distance --model gpt-5-mini --target /tmp/bench
 ```
 
 **Output:**

package/bin/agentic-lib.js

@@ -63,7 +63,7 @@ Options:
   --reseed             Clear features + activity log (keep source code)
   --dry-run            Show what would be done without making changes
   --target <path>      Target repository (default: current directory)
-  --mission <name>     Mission seed name (default: hamming-distance) [purge only]
+  --mission <name>     Mission seed name (default: 6-kyu-understand-hamming-distance) [purge only]
   --mission-file <path>  Use a custom mission file instead of a built-in seed
   --list-missions      List available built-in mission seeds
   --here               Discover the project and generate a MISSION.md, then iterate
@@ -79,7 +79,7 @@ Examples:
   npx @xn-intenton-z2a/agentic-lib transform
   npx @xn-intenton-z2a/agentic-lib maintain-features --model gpt-5-mini
   npx @xn-intenton-z2a/agentic-lib reset --dry-run
-  npx @xn-intenton-z2a/agentic-lib iterate --mission fizz-buzz
+  npx @xn-intenton-z2a/agentic-lib iterate --mission 7-kyu-understand-fizz-buzz
   npx @xn-intenton-z2a/agentic-lib iterate --mission-file ~/my-mission.md
   npx @xn-intenton-z2a/agentic-lib iterate --here
   npx @xn-intenton-z2a/agentic-lib iterate --list-missions
@@ -107,7 +107,7 @@ const target = resolve(targetPath);
 const modelIdx = flags.indexOf("--model");
 const model = modelIdx >= 0 ? flags[modelIdx + 1] : "claude-sonnet-4";
 const missionIdx = flags.indexOf("--mission");
-const mission = missionIdx >= 0 ? flags[missionIdx + 1] : "hamming-distance";
+const mission = missionIdx >= 0 ? flags[missionIdx + 1] : "6-kyu-understand-hamming-distance";
 const cyclesIdx = flags.indexOf("--cycles");
 const cycles = cyclesIdx >= 0 ? parseInt(flags[cyclesIdx + 1], 10) : 0;
 const stepsIdx = flags.indexOf("--steps");
@@ -277,7 +277,7 @@ async function runIterate() {
     }
     console.log(`\n=== Init with custom mission: ${missionFile} ===\n`);
     execSync(
-      `node ${resolve(pkgRoot, "bin/agentic-lib.js")} init --purge --mission empty --target ${target}`,
+      `node ${resolve(pkgRoot, "bin/agentic-lib.js")} init --purge --mission 8-kyu-remember-empty --target ${target}`,
       { encoding: "utf8", timeout: 60000, stdio: "inherit" },
     );
     // Overwrite MISSION.md with the custom file

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xn-intenton-z2a/agentic-lib",
-  "version": "7.4.1",
+  "version": "7.4.3",
   "description": "Agentic-lib Agentic Coding Systems SDK powering automated GitHub workflows.",
   "type": "module",
   "scripts": {

package/src/mcp/server.js

@@ -120,7 +120,7 @@ const TOOLS = [
       properties: {
         mission: {
           type: "string",
-          description: "Mission seed name (e.g. 'hamming-distance', 'fizz-buzz')",
+          description: "Mission seed name (e.g. '6-kyu-understand-hamming-distance', '7-kyu-understand-fizz-buzz')",
         },
         profile: {
           type: "string",

package/src/seeds/zero-package.json

@@ -17,7 +17,7 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@xn-intenton-z2a/agentic-lib": "^7.4.1"
+    "@xn-intenton-z2a/agentic-lib": "^7.4.3"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.0",