skillwiki 0.8.1-beta.8 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.1-beta.8",
+  "version": "0.8.1",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

package/skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.1-beta.8",
+  "version": "0.8.1",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 18 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI.",
   "author": {

package/skills/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.8.1-beta.8",
+  "version": "0.8.1",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 18 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",
@@ -18,6 +18,7 @@
     "karpathy"
   ],
   "skills": "./skills/",
+  "hooks": "./hooks/hooks-codex.json",
   "interface": {
     "displayName": "SkillWiki",
     "shortDescription": "Project-aware wiki skills for Codex agents",

package/skills/README.md

@@ -10,3 +10,13 @@ Prompt-only Markdown skills for Claude Code. Installed via `skillwiki install`.
 Each top-level skill subdirectory holds one canonical `SKILL.md`. The nested
 `skills/<skill>/SKILL.md` tree mirrors those files for Codex plugin discovery;
 keep it byte-for-byte in sync with the canonical top-level files.
+
+Codex installs through `packages/codex-skills`, a materialized plugin root that
+copies this package's `.codex-plugin/` manifest, `skills/` mirror, and
+Codex-specific hook files. That root exposes `hooks/hooks-codex.json` and
+`hooks/session-start-codex` without exposing the Claude default
+`hooks/hooks.json`.
+
+Run `npm run materialize:plugins` from the repository root after changing
+canonical skill, agent, or hook assets. Run
+`npm run materialize:plugins:check` for read-only drift detection.

package/skills/hooks/hooks-codex.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start-codex",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/skills/hooks/session-context

@@ -0,0 +1,112 @@
+#!/usr/bin/env bash
+# Shared SessionStart context helpers for skillwiki hook entrypoints.
+
+read_config_value() {
+    local file="$1"
+    local key="$2"
+    local line
+
+    line=$(grep -E "^[[:space:]]*${key}:" "$file" 2>/dev/null | head -n 1 || true)
+    [[ -n "$line" ]] || return 0
+
+    printf '%s' "$line" \
+        | sed -E "s/^[[:space:]]*${key}:[[:space:]]*//; s/[[:space:]]+#.*$//; s/[[:space:]]+$//; s/^['\"]//; s/['\"]$//"
+}
+
+find_dev_loop_config() {
+    local dir="${PWD}"
+
+    while [[ -n "$dir" && "$dir" != "/" ]]; do
+        if [[ -f "${dir}/.claude/dev-loop.config.md" ]]; then
+            printf '%s' "${dir}/.claude/dev-loop.config.md"
+            return 0
+        fi
+        dir=$(dirname "$dir")
+    done
+
+    return 0
+}
+
+build_project_prd_context() {
+    local config_path
+    config_path=$(find_dev_loop_config)
+    [[ -n "$config_path" ]] || return 0
+
+    local prd_layer
+    local prd_pipeline
+    prd_layer=$(read_config_value "$config_path" "prd_layer")
+    prd_pipeline=$(read_config_value "$config_path" "prd_pipeline")
+
+    [[ -n "$prd_layer" || -n "$prd_pipeline" ]] || return 0
+
+    prd_layer="${prd_layer:-unspecified}"
+    prd_pipeline="${prd_pipeline:-unspecified}"
+
+    cat <<EOF
+## Project PRD Mode
+
+Detected \`.claude/dev-loop.config.md\` for this workspace:
+- \`prd_layer\`: \`${prd_layer}\`
+- \`prd_pipeline\`: \`${prd_pipeline}\`
+
+Use this detected PRD mode as the source of truth. Route generated spec/plan artifacts through \`proj-work\`, and do not write them under \`docs/superpowers/\`. If \`prd_layer\` is \`superpowers\` or \`tdd\`, ensure \`EnterPlanMode\` is gated with \`wiki-gate-plan-mode\`. Do not assume \`superpowers/full\` unless the config says so.
+EOF
+}
+
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+read_skill_content() {
+    local skill_path="$1"
+    cat "$skill_path" 2>/dev/null || echo "Error reading using-skillwiki skill"
+}
+
+resolve_skill_path() {
+    local plugin_root="$1"
+    local skill_name="$2"
+    local candidate
+
+    for candidate in \
+        "${plugin_root}/${skill_name}/SKILL.md" \
+        "${plugin_root}/skills/${skill_name}/SKILL.md"; do
+        if [[ -f "$candidate" ]]; then
+            printf '%s' "$candidate"
+            return 0
+        fi
+    done
+
+    printf '%s' "${plugin_root}/${skill_name}/SKILL.md"
+}
+
+build_skillwiki_session_context() {
+    local skill_content="$1"
+    local project_prd_context
+    local session_context
+
+    project_prd_context=$(build_project_prd_context)
+
+    session_context=$'### Skillwiki Activation\n\nSkillwiki is active for this workspace. Below are the capability guidelines for local reference:'
+    if [[ -n "$project_prd_context" ]]; then
+        session_context+=$'\n\n'
+        session_context+="$project_prd_context"
+    fi
+    session_context+=$'\n\n'
+    session_context+="$skill_content"
+
+    printf '%s' "$session_context"
+}
+
+print_session_start_json() {
+    local session_context
+    session_context=$(escape_for_json "$1")
+
+    # Uses printf instead of heredoc to work around bash 5.3+ heredoc hang.
+    printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"
+}

package/skills/hooks/session-start

@@ -1,29 +1,15 @@
 #!/usr/bin/env bash
 # SessionStart hook for skillwiki plugin
-# Injects using-skillwiki SKILL.md content into every conversation.
 
 set -euo pipefail
 
-PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(cd "$(dirname "$0")/.." && pwd)}"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$(cd "${SCRIPT_DIR}/.." && pwd)}"
 
-skill_content=$(cat "${PLUGIN_ROOT}/using-skillwiki/SKILL.md" 2>/dev/null || echo "Error reading using-skillwiki skill")
+source "${SCRIPT_DIR}/session-context"
 
-# Escape string for JSON embedding using bash parameter substitution.
-# Each ${s//old/new} is a single C-level pass.
-escape_for_json() {
-    local s="$1"
-    s="${s//\\/\\\\}"
-    s="${s//\"/\\\"}"
-    s="${s//$'\n'/\\n}"
-    s="${s//$'\r'/\\r}"
-    s="${s//$'\t'/\\t}"
-    printf '%s' "$s"
-}
-
-skill_escaped=$(escape_for_json "$skill_content")
-session_context="### Skillwiki Activation\n\nSkillwiki is active for this workspace. Below are the capability guidelines for local reference:\n\n${skill_escaped}"
-
-# Uses printf instead of heredoc to work around bash 5.3+ heredoc hang.
-printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"
+skill_content=$(read_skill_content "$(resolve_skill_path "$PLUGIN_ROOT" "using-skillwiki")")
+session_context=$(build_skillwiki_session_context "$skill_content")
+print_session_start_json "$session_context"
 
 exit 0

package/skills/hooks/session-start-codex

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+# Codex SessionStart hook for skillwiki plugin.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="${PLUGIN_ROOT:-$(cd "${SCRIPT_DIR}/.." && pwd)}"
+
+source "${SCRIPT_DIR}/session-context"
+
+skill_content=$(read_skill_content "$(resolve_skill_path "$PLUGIN_ROOT" "using-skillwiki")")
+session_context=$(build_skillwiki_session_context "$skill_content")
+print_session_start_json "$session_context"
+
+exit 0

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.8.1-beta.8",
+  "version": "0.8.1",
   "private": true,
   "files": [
     "wiki-*",