mirror of
https://github.com/Fission-AI/OpenSpec.git
synced 2026-09-14 20:16:53 +08:00
Tabish Bidiwale
af273b8e0b
* proposal: add artifact graph core query system
Add OpenSpec change proposal for Slice 1 of the artifact POC - the core
"What's Ready?" query system. This implements:
- ArtifactGraph class for DAG-based dependency modeling
- Filesystem-based state detection (file existence = completion)
- Topological sort for build order calculation
- Ready/blocked artifact queries
This is a parallel module that will coexist with the current system.
* docs: specify Zod for schema validation in artifact graph proposal
- Add decision section for Zod schema validation in design.md
- Update data structures to show Zod schemas with z.infer<> types
- Update tasks to specify Zod usage for type definitions and parsing
* docs: add 2-level schema resolution and built-in schemas
- Add decision for global → built-in schema resolution pattern
- Add resolver.ts for schema lookup logic
- Add built-in schemas directory (spec-driven.yaml, tdd.yaml)
- Add schema resolution tests
- Follows ESLint/Prettier/Git patterns (defaults baked in package)
* experiment: add vertical slice version of artifact graph change
Creates add-artifact-graph-core-v2 with requirements organized as
vertical slices - each requirement file contains its spec, design
decisions, and tasks bundled together for comparison.
* feat(core): add getGlobalDataDir for XDG-compliant data directory
Add getGlobalDataDir() function following XDG Base Directory Specification
for storing user data like schema overrides:
- XDG_DATA_HOME takes precedence on all platforms
- Unix/macOS fallback: ~/.local/share/openspec/
- Windows fallback: %LOCALAPPDATA%/openspec/
* feat(artifact-graph): add core dependency graph module
Implement Slice 1 ("What's Ready?") of the artifact graph system:
- types.ts: Zod schemas for artifact definitions with derived TypeScript types
- schema.ts: YAML parsing with validation for duplicates, invalid refs, cycles
- graph.ts: ArtifactGraph class with Kahn's algorithm for topological sort
- state.ts: Filesystem-based completion detection with glob pattern support
- resolver.ts: Two-level schema resolution (global override → built-in)
- builtin-schemas.ts: spec-driven and tdd workflow definitions
Key design decisions:
- Filesystem as database (stateless, git-friendly)
- Cycle errors show full path (e.g., "A → B → C → A")
- Deterministic ordering via sorted queues
* test(artifact-graph): add comprehensive test suite
52 tests covering all artifact-graph functionality:
- schema.test.ts: Parsing, validation errors, cycle detection
- graph.test.ts: Build order, ready artifacts, blocked queries
- state.test.ts: File existence, glob patterns, missing directories
- resolver.test.ts: Schema resolution with global overrides
* docs(openspec): archive add-artifact-graph-core change
Archive completed change proposal and create artifact-graph spec with
6 requirements covering schema loading, build order, state detection,
ready queries, completion checks, and blocked queries.
* chore: remove experimental artifact-graph-core-v2 folder
Clean up experimental vertical slice proposal that is no longer needed.
* feat(artifact-graph): validate global schema overrides
Global schema overrides are now validated through the same pipeline as
built-in schemas, catching invalid schemas, cyclic dependencies, and
invalid requires references at load time. Added SchemaLoadError for
better error context with file paths.
* test(artifact-graph): add workflow integration tests
Add end-to-end integration tests that exercise the full artifact-graph
pipeline: resolveSchema → ArtifactGraph → detectCompleted → queries.
Tests cover:
- Complete spec-driven and tdd workflow progressions
- Out-of-order file creation handling
- Glob pattern matching with multiple files
- Build order consistency
- Edge cases (empty/missing directories, non-matching files)
* refactor(artifact-graph): adopt zod v4 error message format
Update custom error messages from string format to zod v4 object format
using `{ error: 'message' }` convention.
* fix(test): prevent hanging vitest threads after test runs
- Add teardownTimeout (3s) to vitest config for forced cleanup
- Add global teardown function to vitest.setup.ts
- Call child.unref() to prevent child processes from blocking event loop
- Explicitly destroy stdio streams on process close/error
82 lines
2.0 KiB
JSON
82 lines
2.0 KiB
JSON
{
|
|
"name": "@fission-ai/openspec",
|
|
"version": "0.17.2",
|
|
"description": "AI-native system for spec-driven development",
|
|
"keywords": [
|
|
"openspec",
|
|
"specs",
|
|
"cli",
|
|
"ai",
|
|
"development"
|
|
],
|
|
"homepage": "https://github.com/Fission-AI/OpenSpec",
|
|
"repository": {
|
|
"type": "git",
|
|
"url": "https://github.com/Fission-AI/OpenSpec"
|
|
},
|
|
"license": "MIT",
|
|
"author": "OpenSpec Contributors",
|
|
"type": "module",
|
|
"publishConfig": {
|
|
"access": "public"
|
|
},
|
|
"exports": {
|
|
".": {
|
|
"types": "./dist/index.d.ts",
|
|
"default": "./dist/index.js"
|
|
}
|
|
},
|
|
"bin": {
|
|
"openspec": "./bin/openspec.js"
|
|
},
|
|
"files": [
|
|
"dist",
|
|
"bin",
|
|
"scripts/postinstall.js",
|
|
"!dist/**/*.test.js",
|
|
"!dist/**/__tests__",
|
|
"!dist/**/*.map"
|
|
],
|
|
"scripts": {
|
|
"lint": "eslint src/",
|
|
"build": "node build.js",
|
|
"dev": "tsc --watch",
|
|
"dev:cli": "pnpm build && node bin/openspec.js",
|
|
"test": "vitest run",
|
|
"test:watch": "vitest",
|
|
"test:ui": "vitest --ui",
|
|
"test:coverage": "vitest --coverage",
|
|
"test:postinstall": "node scripts/postinstall.js",
|
|
"prepare": "pnpm run build",
|
|
"prepublishOnly": "pnpm run build",
|
|
"postinstall": "node scripts/postinstall.js",
|
|
"check:pack-version": "node scripts/pack-version-check.mjs",
|
|
"release": "pnpm run release:ci",
|
|
"release:ci": "pnpm run check:pack-version && pnpm exec changeset publish",
|
|
"release:local": "pnpm exec changeset version && pnpm run check:pack-version && pnpm exec changeset publish",
|
|
"changeset": "changeset"
|
|
},
|
|
"engines": {
|
|
"node": ">=20.19.0"
|
|
},
|
|
"devDependencies": {
|
|
"@changesets/cli": "^2.27.7",
|
|
"@types/node": "^24.2.0",
|
|
"@vitest/ui": "^3.2.4",
|
|
"eslint": "^9.39.2",
|
|
"typescript": "^5.9.3",
|
|
"typescript-eslint": "^8.50.1",
|
|
"vitest": "^3.2.4"
|
|
},
|
|
"dependencies": {
|
|
"@inquirer/core": "^10.2.2",
|
|
"@inquirer/prompts": "^7.8.0",
|
|
"chalk": "^5.5.0",
|
|
"commander": "^14.0.0",
|
|
"fast-glob": "^3.3.3",
|
|
"ora": "^8.2.0",
|
|
"yaml": "^2.8.2",
|
|
"zod": "^4.0.17"
|
|
}
|
|
}
|