knowzcode 0.4.0 → 0.5.2

package/knowzcode/user_preferences.md

@@ -1,120 +1,120 @@
-# User Development Preferences
-
----
-
-**Purpose:** This document captures your personal development preferences and coding standards. These preferences integrate with KnowzCode's workflow while respecting your style and approach.
-
-**Last Updated:** [ISO timestamp - to be filled during init]
-**Source:** User-provided during initialization
-
----
-
-## Core Principles
-
-[User-provided principles, or "Not configured"]
-
-*Examples:*
-- Test-Driven Development (TDD mandatory)
-- Immutable data structures preferred
-- Functional programming patterns
-- Domain-Driven Design (DDD)
-- SOLID principles
-
----
-
-## Testing Approach
-
-[User-provided testing preferences, or "Follows KnowzCode TDD requirements"]
-
-*Examples:*
-- **Framework:** XUnit / Jest / PyTest / Playwright
-- **Style:** Behavior-driven / Unit-first / Integration-focused
-- **Coverage:** Minimum 80% / All public APIs / Critical paths only
-- **Patterns:** AAA (Arrange-Act-Assert) / Given-When-Then
-- **Mocking:** Moq / Jest mocks / unittest.mock
-
----
-
-## Code Style
-
-[User-provided style preferences, or "Standard for language/framework"]
-
-*Examples:*
-- **Naming:** PascalCase for methods, camelCase for variables
-- **Structure:** Small functions (max 20 lines), single responsibility
-- **Comments:** Self-documenting code, minimal comments
-- **Formatting:** Prettier / Black / Standard formatter
-- **Linting:** ESLint / Flake8 / Custom rules
-
----
-
-## Language-Specific Patterns
-
-[User-provided language-specific preferences, or "N/A"]
-
-*Examples (C#):*
-- Nullable reference types always enabled
-- Records for immutable DTOs
-- No null-suppression operators
-- FluentValidation for schema validation
-
-*Examples (JavaScript/TypeScript):*
-- Strict TypeScript mode
-- Functional components with hooks (React)
-- Async/await over promises
-- ESM imports
-
-*Examples (Python):*
-- Type hints for all public functions
-- Dataclasses for structured data
-- f-strings for formatting
-- PEP 8 compliance
-
----
-
-## Quality Priorities
-
-[User-provided quality focus areas, or "Standard KnowzCode priorities"]
-
-*Rank your top priorities (1-5):*
-1. [e.g., Reliability / Security / Performance / Maintainability / Testability]
-2. [...]
-3. [...]
-4. [...]
-5. [...]
-
----
-
-## Project-Specific Conventions
-
-[Any project-specific rules or patterns, or "See project CLAUDE.md"]
-
-*Examples:*
-- Database migrations must be reviewed before merge
-- All API endpoints require OpenAPI documentation
-- Error handling uses Result types (no exceptions)
-- Logging format: structured JSON with correlation IDs
-
----
-
-## Integration with KnowzCode
-
-**Non-Negotiable (KnowzCode Framework):**
-- Test-Driven Development (TDD) is mandatory
-- Quality gates must pass at each phase
-- Living documentation must be maintained
-- Incremental verified progress required
-
-**Flexible (Your Preferences):**
-- Testing framework choice (as long as TDD followed)
-- Code style and naming conventions
-- Language-specific patterns
-- Quality priority ranking
-- Project-specific conventions
-
-**Conflict Resolution:**
-When your preferences conflict with KnowzCode requirements, the framework takes precedence for workflow aspects (TDD, quality gates), but your preferences apply for implementation style (naming, patterns, tools).
-
----
-
-*This document should be reviewed and updated as project conventions evolve.*
+# User Development Preferences
+
+---
+
+**Purpose:** This document captures your personal development preferences and coding standards. These preferences integrate with KnowzCode's workflow while respecting your style and approach.
+
+**Last Updated:** [ISO timestamp - to be filled during init]
+**Source:** User-provided during initialization
+
+---
+
+## Core Principles
+
+[User-provided principles, or "Not configured"]
+
+*Examples:*
+- Test-Driven Development (TDD mandatory)
+- Immutable data structures preferred
+- Functional programming patterns
+- Domain-Driven Design (DDD)
+- SOLID principles
+
+---
+
+## Testing Approach
+
+[User-provided testing preferences, or "Follows KnowzCode TDD requirements"]
+
+*Examples:*
+- **Framework:** XUnit / Jest / PyTest / Playwright
+- **Style:** Behavior-driven / Unit-first / Integration-focused
+- **Coverage:** Minimum 80% / All public APIs / Critical paths only
+- **Patterns:** AAA (Arrange-Act-Assert) / Given-When-Then
+- **Mocking:** Moq / Jest mocks / unittest.mock
+
+---
+
+## Code Style
+
+[User-provided style preferences, or "Standard for language/framework"]
+
+*Examples:*
+- **Naming:** PascalCase for methods, camelCase for variables
+- **Structure:** Small functions (max 20 lines), single responsibility
+- **Comments:** Self-documenting code, minimal comments
+- **Formatting:** Prettier / Black / Standard formatter
+- **Linting:** ESLint / Flake8 / Custom rules
+
+---
+
+## Language-Specific Patterns
+
+[User-provided language-specific preferences, or "N/A"]
+
+*Examples (C#):*
+- Nullable reference types always enabled
+- Records for immutable DTOs
+- No null-suppression operators
+- FluentValidation for schema validation
+
+*Examples (JavaScript/TypeScript):*
+- Strict TypeScript mode
+- Functional components with hooks (React)
+- Async/await over promises
+- ESM imports
+
+*Examples (Python):*
+- Type hints for all public functions
+- Dataclasses for structured data
+- f-strings for formatting
+- PEP 8 compliance
+
+---
+
+## Quality Priorities
+
+[User-provided quality focus areas, or "Standard KnowzCode priorities"]
+
+*Rank your top priorities (1-5):*
+1. [e.g., Reliability / Security / Performance / Maintainability / Testability]
+2. [...]
+3. [...]
+4. [...]
+5. [...]
+
+---
+
+## Project-Specific Conventions
+
+[Any project-specific rules or patterns, or "See project CLAUDE.md"]
+
+*Examples:*
+- Database migrations must be reviewed before merge
+- All API endpoints require OpenAPI documentation
+- Error handling uses Result types (no exceptions)
+- Logging format: structured JSON with correlation IDs
+
+---
+
+## Integration with KnowzCode
+
+**Non-Negotiable (KnowzCode Framework):**
+- Test-Driven Development (TDD) is mandatory
+- Quality gates must pass at each phase
+- Living documentation must be maintained
+- Incremental verified progress required
+
+**Flexible (Your Preferences):**
+- Testing framework choice (as long as TDD followed)
+- Code style and naming conventions
+- Language-specific patterns
+- Quality priority ranking
+- Project-specific conventions
+
+**Conflict Resolution:**
+When your preferences conflict with KnowzCode requirements, the framework takes precedence for workflow aspects (TDD, quality gates), but your preferences apply for implementation style (naming, patterns, tools).
+
+---
+
+*This document should be reviewed and updated as project conventions evolve.*

package/package.json

@@ -1,53 +1,53 @@
-{
-  "name": "knowzcode",
-  "version": "0.4.0",
-  "description": "Platform-agnostic AI development methodology with TDD, quality gates, and structured workflows",
-  "type": "module",
-  "bin": {
-    "knowzcode": "./bin/knowzcode.mjs"
-  },
-  "files": [
-    "bin/",
-    "knowzcode/",
-    "agents/",
-    "commands/",
-    "skills/",
-    ".claude-plugin/"
-  ],
-  "scripts": {
-    "prepublishOnly": "node bin/knowzcode.mjs --version"
-  },
-  "keywords": [
-    "ai",
-    "tdd",
-    "workflow",
-    "methodology",
-    "quality-gates",
-    "platform-agnostic",
-    "claude",
-    "codex",
-    "gemini",
-    "cursor",
-    "copilot",
-    "windsurf",
-    "development"
-  ],
-  "author": {
-    "name": "Alex Headscarf"
-  },
-  "homepage": "https://github.com/knowz-io/knowzcode",
-  "bugs": {
-    "url": "https://github.com/knowz-io/knowzcode/issues"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/knowz-io/knowzcode.git"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "license": "MIT",
-  "engines": {
-    "node": ">=18"
-  }
-}
+{
+  "name": "knowzcode",
+  "version": "0.5.2",
+  "description": "Platform-agnostic AI development methodology with TDD, quality gates, and structured workflows",
+  "type": "module",
+  "bin": {
+    "knowzcode": "./bin/knowzcode.mjs"
+  },
+  "files": [
+    "bin/",
+    "knowzcode/",
+    "agents/",
+    "commands/",
+    "skills/",
+    ".claude-plugin/"
+  ],
+  "scripts": {
+    "prepublishOnly": "node bin/knowzcode.mjs --version"
+  },
+  "keywords": [
+    "ai",
+    "tdd",
+    "workflow",
+    "methodology",
+    "quality-gates",
+    "platform-agnostic",
+    "claude",
+    "codex",
+    "gemini",
+    "cursor",
+    "copilot",
+    "windsurf",
+    "development"
+  ],
+  "author": {
+    "name": "Alex Headscarf"
+  },
+  "homepage": "https://github.com/knowz-io/knowzcode",
+  "bugs": {
+    "url": "https://github.com/knowz-io/knowzcode/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/knowz-io/knowzcode.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/skills/alias-resolver.json

@@ -1,15 +1,15 @@
-{
-  "name": "alias-resolver",
-  "version": "0.4.0",
-  "description": "Resolves friendly natural-language aliases to KnowzCode canonical values (phase, audit, plan, workgroup_type).",
-  "parameters": [
-    {"name": "domain", "type": "string", "required": true},
-    {"name": "text", "type": "string", "required": false}
-  ],
-  "actions": [
-    {
-      "type": "python",
-      "code": "domain = (inputs.get('domain') or '').strip().lower()\ntext = (inputs.get('text') or '').strip().lower()\nresult = {'value': None}\nphase_map = {\n    '1a': {'agent': 'analyst', 'prompt': 'knowzcode/prompts/[LOOP_1A]__Propose_Change_Set.md'},\n    '1b': {'agent': 'architect', 'prompt': 'knowzcode/prompts/[LOOP_1B]__Draft_Specs.md'},\n    '2a': {'agent': 'builder', 'prompt': 'knowzcode/prompts/[LOOP_2A]__Implement_Change_Set.md'},\n    '2b': {'agent': 'reviewer', 'prompt': 'knowzcode/prompts/[LOOP_2B]__Verify_Implementation.md'},\n    '3': {'agent': 'closer', 'prompt': 'knowzcode/prompts/[LOOP_3]__Finalize_And_Commit.md'}\n}\nphase_synonyms = {\n    '1a': ['1a','loop 1a','analyze','analysis','impact','scope','change set','proposal'],\n    '1b': ['1b','loop 1b','spec','specs','draft','design','blueprint'],\n    '2a': ['2a','loop 2a','implement','implementation','build','code','develop'],\n    '2b': ['2b','loop 2b','verify','verification','audit','test','qa','review'],\n    '3': ['3','loop 3','final','finalize','finalization','commit','wrap up','close']\n}\naudit_map = {\n    'spec': 'knowzcode/prompts/Spec_Verification_Checkpoint.md',\n    'implementation': 'knowzcode/prompts/[LOOP_2B]__Verify_Implementation.md',\n    'architecture': None,\n    'security': None,\n    'integration': None\n}\naudit_synonyms = {\n    'spec': ['spec','specs','specification','checkpoint'],\n    'implementation': ['implementation','code','verify implementation','loop 2b'],\n    'architecture': ['architecture','arch','diagram','flowchart','structure'],\n    'security': ['security','sec','owasp','vulnerability'],\n    'integration': ['integration','holistic','system','end to end','e2e']\n}\nworkgroup_map = {'feat': 'feat','feature': 'feat','fix': 'fix','bug': 'fix','bugfix': 'fix','refactor': 'refactor','cleanup': 'refactor','issue': 'issue','incident': 'issue'}\nif domain == 'phase':\n    if not text:\n        key = '1a'\n    else:\n        key = None\n        for canonical, synonyms in phase_synonyms.items():\n            if text == canonical or text in synonyms or any(s in text for s in synonyms):\n                key = canonical\n                break\n        if key is None:\n            for canonical in phase_map.keys():\n                if text.replace(' ','') == canonical:\n                    key = canonical\n                    break\n        if key is None:\n            key = '1a'\n    data = phase_map[key]\n    result['value'] = key.upper()\n    result['prompt'] = data['prompt']\n    result['agent'] = data['agent']\n    result['requires_workgroup'] = data['agent'] != 'analyst'\nelif domain == 'audit':\n    if not text:\n        key = 'spec'\n    else:\n        key = None\n        for canonical, synonyms in audit_synonyms.items():\n            if text == canonical or text in synonyms or any(s in text for s in synonyms):\n                key = canonical\n                break\n        if key is None:\n            key = 'spec'\n    result['value'] = key\n    result['prompt'] = audit_map.get(key)\n    result['agent'] = 'reviewer'\nelif domain == 'plan':\n    result['value'] = text or ''\n    result['prompt'] = None\nelif domain == 'workgroup_type':\n    if not text:\n        value = 'feat'\n    else:\n        value = None\n        for key, mapped in workgroup_map.items():\n            if text == key or key in text:\n                value = mapped\n                break\n        if value is None:\n            value = workgroup_map.get(text, 'feat')\n    result['value'] = value\nelse:\n    result['value'] = text or ''\noutputs.update(result)\n"
-    }
-  ]
-}
+{
+  "name": "alias-resolver",
+  "version": "0.5.2",
+  "description": "Resolves friendly natural-language aliases to KnowzCode canonical values (phase, audit, plan, workgroup_type).",
+  "parameters": [
+    {"name": "domain", "type": "string", "required": true},
+    {"name": "text", "type": "string", "required": false}
+  ],
+  "actions": [
+    {
+      "type": "python",
+      "code": "domain = (inputs.get('domain') or '').strip().lower()\ntext = (inputs.get('text') or '').strip().lower()\nresult = {'value': None}\nphase_map = {\n    '1a': {'agent': 'analyst', 'prompt': 'knowzcode/prompts/[LOOP_1A]__Propose_Change_Set.md'},\n    '1b': {'agent': 'architect', 'prompt': 'knowzcode/prompts/[LOOP_1B]__Draft_Specs.md'},\n    '2a': {'agent': 'builder', 'prompt': 'knowzcode/prompts/[LOOP_2A]__Implement_Change_Set.md'},\n    '2b': {'agent': 'reviewer', 'prompt': 'knowzcode/prompts/[LOOP_2B]__Verify_Implementation.md'},\n    '3': {'agent': 'closer', 'prompt': 'knowzcode/prompts/[LOOP_3]__Finalize_And_Commit.md'}\n}\nphase_synonyms = {\n    '1a': ['1a','loop 1a','analyze','analysis','impact','scope','change set','proposal'],\n    '1b': ['1b','loop 1b','spec','specs','draft','design','blueprint'],\n    '2a': ['2a','loop 2a','implement','implementation','build','code','develop'],\n    '2b': ['2b','loop 2b','verify','verification','audit','test','qa','review'],\n    '3': ['3','loop 3','final','finalize','finalization','commit','wrap up','close']\n}\naudit_map = {\n    'spec': 'knowzcode/prompts/Spec_Verification_Checkpoint.md',\n    'implementation': 'knowzcode/prompts/[LOOP_2B]__Verify_Implementation.md',\n    'architecture': None,\n    'security': None,\n    'integration': None\n}\naudit_synonyms = {\n    'spec': ['spec','specs','specification','checkpoint'],\n    'implementation': ['implementation','code','verify implementation','loop 2b'],\n    'architecture': ['architecture','arch','diagram','flowchart','structure'],\n    'security': ['security','sec','owasp','vulnerability'],\n    'integration': ['integration','holistic','system','end to end','e2e']\n}\nworkgroup_map = {'feat': 'feat','feature': 'feat','fix': 'fix','bug': 'fix','bugfix': 'fix','refactor': 'refactor','cleanup': 'refactor','issue': 'issue','incident': 'issue'}\nif domain == 'phase':\n    if not text:\n        key = '1a'\n    else:\n        key = None\n        for canonical, synonyms in phase_synonyms.items():\n            if text == canonical or text in synonyms or any(s in text for s in synonyms):\n                key = canonical\n                break\n        if key is None:\n            for canonical in phase_map.keys():\n                if text.replace(' ','') == canonical:\n                    key = canonical\n                    break\n        if key is None:\n            key = '1a'\n    data = phase_map[key]\n    result['value'] = key.upper()\n    result['prompt'] = data['prompt']\n    result['agent'] = data['agent']\n    result['requires_workgroup'] = data['agent'] != 'analyst'\nelif domain == 'audit':\n    if not text:\n        key = 'spec'\n    else:\n        key = None\n        for canonical, synonyms in audit_synonyms.items():\n            if text == canonical or text in synonyms or any(s in text for s in synonyms):\n                key = canonical\n                break\n        if key is None:\n            key = 'spec'\n    result['value'] = key\n    result['prompt'] = audit_map.get(key)\n    result['agent'] = 'reviewer'\nelif domain == 'plan':\n    result['value'] = text or ''\n    result['prompt'] = None\nelif domain == 'workgroup_type':\n    if not text:\n        value = 'feat'\n    else:\n        value = None\n        for key, mapped in workgroup_map.items():\n            if text == key or key in text:\n                value = mapped\n                break\n        if value is None:\n            value = workgroup_map.get(text, 'feat')\n    result['value'] = value\nelse:\n    result['value'] = text or ''\noutputs.update(result)\n"
+    }
+  ]
+}

package/skills/architecture-diff.json

@@ -1,12 +1,12 @@
-{
-  "name": "architecture-diff",
-  "version": "0.4.0",
-  "description": "Highlights differences between specs and the Mermaid flowchart in knowzcode_architecture.md.",
-  "parameters": [],
-  "actions": [
-    {
-      "type": "python",
-      "code": "from pathlib import Path\nimport re\narch = Path('knowzcode/knowzcode_architecture.md').read_text()\nspec_paths = list(Path('knowzcode/specs').glob('*.md'))\nnode_ids = {p.stem for p in spec_paths}\nmermaid_nodes = set(re.findall(r'([A-Z]{2,}_[A-Za-z0-9]+)', arch))\nmissing_in_arch = sorted(node_ids - mermaid_nodes)\nmissing_in_specs = sorted(mermaid_nodes - node_ids)\noutputs['missing_in_architecture'] = missing_in_arch\noutputs['missing_specs'] = missing_in_specs\n"
-    }
-  ]
-}
+{
+  "name": "architecture-diff",
+  "version": "0.5.2",
+  "description": "Highlights differences between specs and the Mermaid flowchart in knowzcode_architecture.md.",
+  "parameters": [],
+  "actions": [
+    {
+      "type": "python",
+      "code": "from pathlib import Path\nimport re\narch = Path('knowzcode/knowzcode_architecture.md').read_text()\nspec_paths = list(Path('knowzcode/specs').glob('*.md'))\nnode_ids = {p.stem for p in spec_paths}\nmermaid_nodes = set(re.findall(r'([A-Z]{2,}_[A-Za-z0-9]+)', arch))\nmissing_in_arch = sorted(node_ids - mermaid_nodes)\nmissing_in_specs = sorted(mermaid_nodes - node_ids)\noutputs['missing_in_architecture'] = missing_in_arch\noutputs['missing_specs'] = missing_in_specs\n"
+    }
+  ]
+}

package/skills/check-installation-status.json

@@ -1,14 +1,14 @@
-{
-  "name": "check-installation-status",
-  "version": "0.4.0",
-  "description": "Checks if KnowzCode is initialized in the current project and reports current status",
-
-  "parameters": [],
-
-  "actions": [
-    {
-      "type": "python",
-      "code": "from pathlib import Path\n\nknowzcode_dir = Path('knowzcode')\n\nif not knowzcode_dir.exists():\n    outputs['initialized'] = False\n    outputs['commands_count'] = 0\n    outputs['skills_count'] = 0\n    outputs['agents_count'] = 0\n    outputs['has_required_files'] = False\n    exit()\n\n# Check required files exist\nrequired_files = [\n    'knowzcode_loop.md',\n    'knowzcode_tracker.md',\n    'knowzcode_project.md',\n    'knowzcode_architecture.md'\n]\n\nmissing_files = [f for f in required_files if not (knowzcode_dir / f).exists()]\nhas_required_files = len(missing_files) == 0\n\n# Count components from various possible locations\n\n# Check .claude directory\nclaude_dir = Path('.claude')\ncommands_count = 0\nskills_count = 0\nagents_count = 0\n\nif claude_dir.exists():\n    if (claude_dir / 'commands').exists():\n        commands_count = len(list((claude_dir / 'commands').glob('*.md')))\n    if (claude_dir / 'skills').exists():\n        skills_count = len(list((claude_dir / 'skills').glob('*.json')))\n    if (claude_dir / 'agents').exists():\n        agents_count = len(list((claude_dir / 'agents').glob('*.md')))\n    if (claude_dir / 'subagents').exists():\n        agents_count += len(list((claude_dir / 'subagents').glob('*.yaml')))\n\n# Also check top-level directories (plugin installation)\nif Path('commands').exists():\n    commands_count = max(commands_count, len(list(Path('commands').glob('*.md'))))\nif Path('skills').exists():\n    skills_count = max(skills_count, len(list(Path('skills').glob('*.json'))))\nif Path('agents').exists():\n    agents_count = max(agents_count, len(list(Path('agents').glob('*.md'))))\n\noutputs['initialized'] = has_required_files\noutputs['commands_count'] = commands_count\noutputs['skills_count'] = skills_count\noutputs['agents_count'] = agents_count\noutputs['has_required_files'] = has_required_files\noutputs['missing_files'] = missing_files if missing_files else None"
-    }
-  ]
-}
+{
+  "name": "check-installation-status",
+  "version": "0.5.2",
+  "description": "Checks if KnowzCode is initialized in the current project and reports current status",
+
+  "parameters": [],
+
+  "actions": [
+    {
+      "type": "python",
+      "code": "from pathlib import Path\n\nknowzcode_dir = Path('knowzcode')\n\nif not knowzcode_dir.exists():\n    outputs['initialized'] = False\n    outputs['commands_count'] = 0\n    outputs['skills_count'] = 0\n    outputs['agents_count'] = 0\n    outputs['has_required_files'] = False\n    exit()\n\n# Check required files exist\nrequired_files = [\n    'knowzcode_loop.md',\n    'knowzcode_tracker.md',\n    'knowzcode_project.md',\n    'knowzcode_architecture.md'\n]\n\nmissing_files = [f for f in required_files if not (knowzcode_dir / f).exists()]\nhas_required_files = len(missing_files) == 0\n\n# Count components from various possible locations\n\n# Check .claude directory\nclaude_dir = Path('.claude')\ncommands_count = 0\nskills_count = 0\nagents_count = 0\n\nif claude_dir.exists():\n    if (claude_dir / 'commands').exists():\n        commands_count = len(list((claude_dir / 'commands').glob('*.md')))\n    if (claude_dir / 'skills').exists():\n        skills_count = len(list((claude_dir / 'skills').glob('*.json')))\n    if (claude_dir / 'agents').exists():\n        agents_count = len(list((claude_dir / 'agents').glob('*.md')))\n    if (claude_dir / 'subagents').exists():\n        agents_count += len(list((claude_dir / 'subagents').glob('*.yaml')))\n\n# Also check top-level directories (plugin installation)\nif Path('commands').exists():\n    commands_count = max(commands_count, len(list(Path('commands').glob('*.md'))))\nif Path('skills').exists():\n    skills_count = max(skills_count, len(list(Path('skills').glob('*.json'))))\nif Path('agents').exists():\n    agents_count = max(agents_count, len(list(Path('agents').glob('*.md'))))\n\noutputs['initialized'] = has_required_files\noutputs['commands_count'] = commands_count\noutputs['skills_count'] = skills_count\noutputs['agents_count'] = agents_count\noutputs['has_required_files'] = has_required_files\noutputs['missing_files'] = missing_files if missing_files else None"
+    }
+  ]
+}