Skip to content

feat: package IDD toolkit as npm + reusable GitHub Action#20

Merged
slusset merged 6 commits intomainfrom
feat/idd-toolkit-package
Mar 7, 2026
Merged

feat: package IDD toolkit as npm + reusable GitHub Action#20
slusset merged 6 commits intomainfrom
feat/idd-toolkit-package

Conversation

@slusset
Copy link
Owner

@slusset slusset commented Mar 7, 2026

Summary

  • Adds root package.json (idd-toolkit@0.1.0) with bin/idd.js CLI entrypoint
  • Creates reusable composite action at .github/actions/idd-check/
  • Simplifies CI workflow from ~400 lines to 3-line action reference
  • Deprecates link-skills.sh and build.sh with migration notices
  • Preserves tools/package.json for backward compatibility

CLI subcommands

idd validate all [--json]
idd install-skills <claude|codex|all> [--with-technical] [--link]
idd generate-evidence --capability <path>
idd init [dir]
idd version

Test plan

  • idd validate all runs 6/6 validators against example specs
  • idd validate traceability front-matter --json works with multiple checks
  • idd install-skills claude copies skills + writes version marker
  • idd init /tmp/test scaffolds full directory structure
  • npm pack --dry-run produces 102KB tarball with 45 files
  • CI workflow passes using the new composite action

Closes #19

🤖 Generated with Claude Code

…GitHub Action

Adds a root package.json (idd-toolkit) with a `bin/idd.js` CLI entrypoint
that unifies skill installation and validation into a single versioned
package. Replaces ad-hoc symlinks and npm-link workflows with:

- `idd validate [check...] [--json]` — runs validators
- `idd install-skills <claude|codex|all>` — copies versioned skills
- `idd generate-evidence` — wraps evidence generator
- `idd init` — scaffolds specs/ structure in new projects

Also extracts the CI workflow into a reusable composite action at
.github/actions/idd-check/ that consuming repos can reference directly.
Existing tools/package.json preserved for backward compatibility.

Closes #19

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@chatgpt-codex-connector
Copy link

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@github-actions
Copy link

github-actions bot commented Mar 7, 2026

IDD Compliance Review

Check Status Errors Warnings
Traceability 0 0
Front-Matter 0 0
Capability Scope 0 0
Fixtures 0 0
Models 0 3
Journey Maps 0 0
OpenAPI Lint 0
Gherkin Lint 0
✅ Traceability

Info

  • Found 1 persona file(s)
  • Checked 1 journey file(s)
  • Checked 2 story file(s)
  • Checked 1 feature file(s)
  • Checked 2 API operation(s) across 1 contract file(s)
  • Checked 1 fixture file(s)
  • Checked 1 journey map(s)
  • Checked 1 model file(s)
✅ Front-Matter

Info

  • Checked 9 spec file(s): 9 passed, 0 with issues
✅ Capability Scope

Info

  • Found 1 capability file(s): trade-show-signup
  • Scope coverage: 5/5 files covered
✅ Fixtures

Info

  • specs/fixtures/mobile-signup.fixture.yaml: valid
  • Validated 1 fixture file(s)
✅ Models

Warnings

  • specs/models/account.model.yaml: Entity should have a description
  • specs/models/account.model.yaml: Entity should define identity field
  • specs/models/account.model.yaml: Rule "account-activates-on-signup" should have a description

Info

  • Validated 1 model file(s)
✅ Journey Maps

Info

  • specs/journey-maps/trade-show-signup.journey-map.yaml: valid
  • Validated 1 journey map file(s)
✅ OpenAPI Lint
No results with a severity of 'error' found!

Total: 0 error(s), 3 warning(s)

Automated by IDD Toolkit

slusset and others added 5 commits March 7, 2026 11:07
- `idd install-skills --check` detects outdated or missing skill
  installations by comparing the .idd-skills-version marker against
  the current package version (exit 1 if stale)
- README rewritten with new CLI-first install instructions, reusable
  action usage, and updated repo layout
- CHANGELOG.md added following Keep a Changelog format

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Reworks the composite action to run each validator individually and
capture per-check JSON results. The summary now renders as:

- Overview table with status/errors/warnings per check
- Collapsible detail sections with errors, warnings, and info
- Spec-before-code warning with affected file list
- Footer with total counts and failed check names

Exit codes stored in a JSON file rather than dynamic step outputs
to avoid GitHub Actions expression limitations.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Operations may reference multiple features via x-feature as an array.
Previously only a single string was supported, causing false negatives
when an operation mapped to more than one feature file.

Upstreamed from edyoucate-ai/scripts divergence.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Mirrors the same x-feature array support added to validate-traceability.
Operations may map to multiple features; the evidence generator now
correctly matches and counts coverage for multi-feature operations.

Upstreamed from edyoucate-ai/scripts divergence.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@slusset slusset merged commit cac4077 into main Mar 7, 2026
1 check passed
@slusset slusset deleted the feat/idd-toolkit-package branch March 7, 2026 17:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Package IDD toolkit as npm + reusable GitHub Action

1 participant