trace-to-skill 0.1.85 → 0.1.86

package/README.md

@@ -499,6 +499,7 @@ Stable machine-readable contracts are published with the npm package and release
 - [`schemas/session-audit-result.schema.json`](schemas/session-audit-result.schema.json) describes `trace-to-skill session-audit --format json`.
 - [`schemas/usage-evidence-result.schema.json`](schemas/usage-evidence-result.schema.json) describes `trace-to-skill usage-evidence --format json`.
 - [`schemas/process-audit-result.schema.json`](schemas/process-audit-result.schema.json) describes `trace-to-skill process-audit --format json`.
+- [`schemas/issue-map-result.schema.json`](schemas/issue-map-result.schema.json) describes `trace-to-skill issue-map --format json`.
 - [`schemas/workspace-checkpoint-result.schema.json`](schemas/workspace-checkpoint-result.schema.json) describes `trace-to-skill checkpoint --format json`.
 
 These schemas let downstream Codex workflows, dashboards, and CI bots consume reports without scraping Markdown.
@@ -531,7 +532,7 @@ jobs:
       issues: write
     steps:
       - uses: actions/checkout@v5
-      - uses: grnbtqdbyx-create/trace-to-skill@v0.1.85
+      - uses: grnbtqdbyx-create/trace-to-skill@v0.1.86
         with:
           mode: all
           doctor-threshold: "85"
@@ -580,7 +581,7 @@ Composite action usage:
 
 ```yaml
 - id: trace-to-skill
-  uses: grnbtqdbyx-create/trace-to-skill@v0.1.85
+  uses: grnbtqdbyx-create/trace-to-skill@v0.1.86
   with:
     mode: all
     doctor-threshold: "85"
@@ -594,6 +595,18 @@ Composite action usage:
 - run: echo "Codex readiness score is ${{ steps.trace-to-skill.outputs.doctor-score }}"
 ```
 
+Issue-map action usage for a committed or downloaded GitHub issue export:
+
+```yaml
+- id: codex-issue-map
+  uses: grnbtqdbyx-create/trace-to-skill@v0.1.86
+  with:
+    mode: issue-map
+    issue-map-path: codex-issues.json
+    job-summary: "true"
+- run: echo "Top Codex issue cluster is ${{ steps.codex-issue-map.outputs.issue-map-top-kind }}"
+```
+
 Action outputs:
 
 | Output | Description |
@@ -619,10 +632,15 @@ Action outputs:
 | `scorecard-status` | Combined scorecard status, `pass` or `fail` |
 | `scorecard-report` | Markdown scorecard report path |
 | `scorecard-json` | JSON scorecard report path |
+| `issue-map-issues` | Number of GitHub issues analyzed by issue-map mode |
+| `issue-map-matched` | Number of issues matched to deterministic failure classes |
+| `issue-map-top-kind` | Highest-priority issue-map failure class |
+| `issue-map-report` | Markdown issue-map report path |
+| `issue-map-json` | JSON issue-map report path |
 
 By default, generated reports are also appended to the GitHub Actions Job Summary. Set `job-summary: "false"` to disable that UI output.
 
-Tagged Action releases build and run the CLI from `$GITHUB_ACTION_PATH`, so a workflow pinned to a release tag such as `@v0.1.85` executes that release's checked-out source instead of pulling the default branch at runtime.
+Tagged Action releases build and run the CLI from `$GITHUB_ACTION_PATH`, so a workflow pinned to a release tag such as `@v0.1.86` executes that release's checked-out source instead of pulling the default branch at runtime.
 
 ## Codex Skill
 

package/docs/DISCOVERY.md

@@ -150,6 +150,7 @@ npx trace-to-skill suggest ./runs --target agents-md
 - `schemas/session-audit-result.schema.json`
 - `schemas/usage-evidence-result.schema.json`
 - `schemas/process-audit-result.schema.json`
+- `schemas/issue-map-result.schema.json`
 - `schemas/workspace-checkpoint-result.schema.json`
 
 ## Related Keywords

package/docs/OPENAI_OSS_BRIEF.md

@@ -3,34 +3,35 @@
 | Field | Value |
 | --- | --- |
 | Repository | https://github.com/grnbtqdbyx-create/trace-to-skill |
-| Package | trace-to-skill@0.1.85 |
+| Package | trace-to-skill@0.1.86 |
 | License | Apache-2.0 |
 | Codex readiness | ready (100/100) |
 | Benchmark | pass, 38 cases |
 
 ## Why This Repository Qualifies
 
-trace-to-skill helps open-source maintainers adopt Codex safely by turning failed coding-agent runs into evidence-backed rules, reusable workflows, and CI gates. It supports real maintenance work: PR review, issue triage, release quality, MCP risk, prompt-injection defense, privacy-preserving trace sharing, and repeat failure reduction. The repository is ready, scores 100/100 on the local Codex readiness doctor, and ships a deterministic benchmark with 38 public fixture cases.
+trace-to-skill helps open-source maintainers adopt Codex safely by turning failed coding-agent runs into evidence-backed rules, reusable workflows, and CI gates. It supports real maintenance work: PR review, GitHub issue demand mining, release quality, MCP risk, prompt-injection defense, privacy-preserving trace sharing, and repeat failure reduction. The repository is ready, scores 100/100 on the local Codex readiness doctor, and ships a deterministic benchmark with 38 public fixture cases.
 
 ### 500-Character Version
 
-> trace-to-skill helps open-source maintainers adopt Codex safely by turning failed coding-agent runs into evidence-backed rules, reusable workflows, and CI gates. It supports real maintenance work: PR review, issue triage, release quality, MCP risk, prompt-injection defense, privacy-preserving trace sharing, and repeat failure reduction. The repository is ready, scores 100/100 on the local Codex readiness doctor, and ships a deterministic benchmark with 38 public fixture cases.
+> trace-to-skill helps open-source maintainers adopt Codex safely by turning failed coding-agent runs into evidence-backed rules, reusable workflows, and CI gates. It supports real maintenance work: PR review, GitHub issue demand mining, release quality, MCP risk, prompt-injection defense, privacy-preserving trace sharing, and repeat failure reduction. The repository is ready, scores 100/100 on the local Codex readiness doctor, and ships a deterministic benchmark with 38 public fixture cases.
 
 ## How API Credits Would Be Used
 
-API credits would power optional maintainer workflows on top of the local deterministic scanner: classifying failed Codex sessions, generating candidate AGENTS.md rules or SKILL.md workflows, comparing before/after runs, and producing PR-ready triage reports. The local CLI remains free, dependency-light, and usable without API credits.
+API credits would power optional maintainer workflows on top of the local deterministic scanner: classifying failed Codex sessions, mining public GitHub issue clusters, generating candidate AGENTS.md rules or SKILL.md workflows, comparing before/after runs, and producing PR-ready triage reports. The local CLI remains free, dependency-light, and usable without API credits.
 
 ### 500-Character Version
 
-> API credits would power optional maintainer workflows on top of the local deterministic scanner: classifying failed Codex sessions, generating candidate AGENTS.md rules or SKILL.md workflows, comparing before/after runs, and producing PR-ready triage reports. The local CLI remains free, dependency-light, and usable without API credits.
+> API credits would power optional maintainer workflows on top of the local deterministic scanner: classifying failed Codex sessions, mining public GitHub issue clusters, generating candidate AGENTS.md rules or SKILL.md workflows, comparing before/after runs, and producing PR-ready triage reports. The local CLI remains free, dependency-light, and usable without API credits.
 
 ## Evidence
 
 - Public repository: https://github.com/grnbtqdbyx-create/trace-to-skill
-- One-command package: npx trace-to-skill@0.1.85
+- One-command package: npx trace-to-skill@0.1.86
 - Open-source license: Apache-2.0
 - Codex readiness doctor: ready, 100/100, 0 failed checks.
 - Public fixture benchmark: pass, 38 cases.
+- GitHub issue demand mining: issue-map ranks exported OpenAI/Codex issues by failure class, comments, reactions, and evidence gaps.
 - Maintainer control: generated rules are suggestions, evidence is line-linked, and secrets can be redacted before sharing.
 
 ## Next Steps Before Submitting

package/docs/USE_CASES.md

@@ -59,7 +59,7 @@ What it proves:
 Recommended CI surface:
 
 ```yaml
-- uses: grnbtqdbyx-create/trace-to-skill@v0.1.85
+- uses: grnbtqdbyx-create/trace-to-skill@v0.1.86
   with:
     mode: all
     doctor-threshold: "85"

package/llms.txt

@@ -120,7 +120,7 @@ npx trace-to-skill init --comment --sarif
 ## GitHub Action
 
 ```yaml
-- uses: grnbtqdbyx-create/trace-to-skill@v0.1.85
+- uses: grnbtqdbyx-create/trace-to-skill@v0.1.86
   with:
     mode: all
     doctor-threshold: "85"
@@ -146,6 +146,7 @@ npx trace-to-skill init --comment --sarif
 - Session audit JSON schema: https://github.com/grnbtqdbyx-create/trace-to-skill/blob/main/schemas/session-audit-result.schema.json
 - Usage evidence JSON schema: https://github.com/grnbtqdbyx-create/trace-to-skill/blob/main/schemas/usage-evidence-result.schema.json
 - Process audit JSON schema: https://github.com/grnbtqdbyx-create/trace-to-skill/blob/main/schemas/process-audit-result.schema.json
+- Issue map JSON schema: https://github.com/grnbtqdbyx-create/trace-to-skill/blob/main/schemas/issue-map-result.schema.json
 - Workspace checkpoint JSON schema: https://github.com/grnbtqdbyx-create/trace-to-skill/blob/main/schemas/workspace-checkpoint-result.schema.json
 
 ## Search phrases this project should answer

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trace-to-skill",
-  "version": "0.1.85",
+  "version": "0.1.86",
   "description": "Turn failed AI coding-agent runs into reusable AGENTS.md rules, SKILL.md files, and eval evidence.",
   "type": "module",
   "main": "dist/src/index.js",
@@ -142,7 +142,9 @@
     "codex-project-history",
     "codex-issue-report",
     "codex-issue-map",
+    "codex-issue-map-action",
     "github-issue-map",
+    "github-action-issue-map",
     "openai-issue-mining",
     "maintainer-pain-map",
     "openai-triage",

package/schemas/issue-map-result.schema.json

@@ -0,0 +1,137 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/grnbtqdbyx-create/trace-to-skill/main/schemas/issue-map-result.schema.json",
+  "title": "trace-to-skill issue-map result",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "generatedAt",
+    "sources",
+    "issueCount",
+    "matchedIssueCount",
+    "unmatchedIssueCount",
+    "summaries",
+    "unmatchedIssues"
+  ],
+  "properties": {
+    "generatedAt": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "string"
+      }
+    },
+    "issueCount": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "matchedIssueCount": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "unmatchedIssueCount": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "summaries": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/summary"
+      }
+    },
+    "unmatchedIssues": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/example"
+      }
+    }
+  },
+  "$defs": {
+    "severity": {
+      "type": "string",
+      "enum": ["low", "medium", "high", "critical"]
+    },
+    "example": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "title", "comments", "labels"],
+      "properties": {
+        "id": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        },
+        "comments": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "labels": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "title",
+        "severity",
+        "issues",
+        "comments",
+        "reactions",
+        "priorityScore",
+        "examples",
+        "suggestedRules"
+      ],
+      "properties": {
+        "kind": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "severity": {
+          "$ref": "#/$defs/severity"
+        },
+        "issues": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "comments": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "reactions": {
+          "type": "integer",
+          "minimum": 0
+        },
+        "priorityScore": {
+          "type": "integer"
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/example"
+          }
+        },
+        "suggestedRules": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      }
+    }
+  }
+}