@libar-dev/architect 1.0.0-pre.3

package/docs-live/validation/error-catalog.md

@@ -0,0 +1,78 @@
+# Error Catalog
+
+**Purpose:** Complete error message reference with fix instructions
+
+---
+
+## Error Catalog
+
+Complete error messages and fix instructions for all 6 validation rules.
+
+| Rule ID                     | Severity | Description                                         |
+| --------------------------- | -------- | --------------------------------------------------- |
+| `completed-protection`      | error    | Completed specs require unlock-reason tag to modify |
+| `invalid-status-transition` | error    | Status transitions must follow FSM path             |
+| `scope-creep`               | error    | Active specs cannot add new deliverables            |
+| `session-scope`             | warning  | File outside session scope                          |
+| `session-excluded`          | error    | File explicitly excluded from session               |
+| `deliverable-removed`       | warning  | Deliverable was removed from spec                   |
+
+## Rule Details
+
+### `completed-protection`
+
+| Property    | Value                                                             |
+| ----------- | ----------------------------------------------------------------- |
+| Severity    | error                                                             |
+| Description | Completed specs require unlock-reason tag to modify               |
+| Cause       | File has `completed` status but no `@architect-unlock-reason` tag |
+| Fix         | Add `@architect-unlock-reason:'your reason'` to proceed           |
+
+### `invalid-status-transition`
+
+| Property    | Value                                                |
+| ----------- | ---------------------------------------------------- |
+| Severity    | error                                                |
+| Description | Status transitions must follow FSM path              |
+| Cause       | Attempted transition not in VALID_TRANSITIONS matrix |
+| Fix         | Follow path: roadmap -> active -> completed          |
+
+### `scope-creep`
+
+| Property    | Value                                               |
+| ----------- | --------------------------------------------------- |
+| Severity    | error                                               |
+| Description | Active specs cannot add new deliverables            |
+| Cause       | Added deliverable to spec with `active` status      |
+| Fix         | Create new spec OR revert to `roadmap` status first |
+
+### `session-scope`
+
+| Property    | Value                                               |
+| ----------- | --------------------------------------------------- |
+| Severity    | warning                                             |
+| Description | File outside session scope                          |
+| Cause       | Modified file not in session's scopedSpecs list     |
+| Fix         | Add to session scope OR use `--ignore-session` flag |
+
+### `session-excluded`
+
+| Property    | Value                                          |
+| ----------- | ---------------------------------------------- |
+| Severity    | error                                          |
+| Description | File explicitly excluded from session          |
+| Cause       | File in session's excludedSpecs list           |
+| Fix         | Remove from exclusion OR use different session |
+
+### `deliverable-removed`
+
+| Property    | Value                                               |
+| ----------- | --------------------------------------------------- |
+| Severity    | warning                                             |
+| Description | Deliverable was removed from spec                   |
+| Cause       | Deliverable removed from Background table           |
+| Fix         | Document reason for removal (completed or descoped) |
+
+---
+
+[Back to Validation Rules](../VALIDATION-RULES.md)

package/docs-live/validation/fsm-transitions.md

@@ -0,0 +1,50 @@
+# FSM Transitions
+
+**Purpose:** Complete state transition reference for Process Guard FSM
+
+---
+
+## FSM Transition Matrix
+
+Complete transition matrix showing all valid state changes per PDR-005.
+
+| From        | To          | Description                            |
+| ----------- | ----------- | -------------------------------------- |
+| `roadmap`   | `active`    | Start implementation work              |
+| `roadmap`   | `deferred`  | Park work for later                    |
+| `roadmap`   | `roadmap`   | Stay in planning (self-transition)     |
+| `active`    | `completed` | Finish implementation                  |
+| `active`    | `roadmap`   | Regress due to blocker or scope change |
+| `completed` | (none)      | Terminal state - no valid transitions  |
+| `deferred`  | `roadmap`   | Reactivate deferred work               |
+
+## Transitions by State
+
+### From `roadmap`
+
+| Target     | Description                        |
+| ---------- | ---------------------------------- |
+| `active`   | Start implementation work          |
+| `deferred` | Park work for later                |
+| `roadmap`  | Stay in planning (self-transition) |
+
+### From `active`
+
+| Target      | Description                            |
+| ----------- | -------------------------------------- |
+| `completed` | Finish implementation                  |
+| `roadmap`   | Regress due to blocker or scope change |
+
+### From `completed`
+
+**Terminal state** - no valid transitions. Use `@architect-unlock-reason` to modify.
+
+### From `deferred`
+
+| Target    | Description              |
+| --------- | ------------------------ |
+| `roadmap` | Reactivate deferred work |
+
+---
+
+[Back to Validation Rules](../VALIDATION-RULES.md)

package/docs-live/validation/protection-levels.md

@@ -0,0 +1,51 @@
+# Protection Levels
+
+**Purpose:** Detailed protection level reference per PDR-005
+
+---
+
+## Protection Levels
+
+Detailed explanation of protection levels per PDR-005 MVP Workflow.
+
+| Level   | Applies To            | Meaning                                         |
+| ------- | --------------------- | ----------------------------------------------- |
+| `none`  | `roadmap`, `deferred` | Fully editable, no restrictions                 |
+| `scope` | `active`              | Scope-locked, prevents adding new deliverables  |
+| `hard`  | `completed`           | Hard-locked, requires explicit unlock to modify |
+
+## Level Details
+
+### `none` Protection
+
+**Applies to:** `roadmap`, `deferred`
+
+| Aspect  | Description                                         |
+| ------- | --------------------------------------------------- |
+| Meaning | Fully editable, no restrictions                     |
+| Allowed | All modifications including adding new deliverables |
+| Blocked | Nothing                                             |
+
+### `scope` Protection
+
+**Applies to:** `active`
+
+| Aspect  | Description                                    |
+| ------- | ---------------------------------------------- |
+| Meaning | Scope-locked, prevents adding new deliverables |
+| Allowed | Edit existing deliverables, change status      |
+| Blocked | Adding new deliverables (scope creep)          |
+
+### `hard` Protection
+
+**Applies to:** `completed`
+
+| Aspect  | Description                                     |
+| ------- | ----------------------------------------------- |
+| Meaning | Hard-locked, requires explicit unlock to modify |
+| Allowed | Nothing (without unlock-reason tag)             |
+| Blocked | All modifications                               |
+
+---
+
+[Back to Validation Rules](../VALIDATION-RULES.md)

package/package.json

@@ -0,0 +1,233 @@
+{
+  "name": "@libar-dev/architect",
+  "version": "1.0.0-pre.3",
+  "description": "Context engineering platform: extract patterns from TypeScript and Gherkin into a queryable state with living docs, architecture graphs, and FSM-enforced workflows.",
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "import": "./dist/api/index.js"
+    },
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js"
+    },
+    "./lint": {
+      "types": "./dist/lint/index.d.ts",
+      "import": "./dist/lint/index.js"
+    },
+    "./renderable": {
+      "types": "./dist/renderable/index.d.ts",
+      "import": "./dist/renderable/index.js"
+    },
+    "./generators": {
+      "types": "./dist/generators/index.d.ts",
+      "import": "./dist/generators/index.js"
+    },
+    "./scanner": {
+      "types": "./dist/scanner/index.d.ts",
+      "import": "./dist/scanner/index.js"
+    },
+    "./extractor": {
+      "types": "./dist/extractor/index.d.ts",
+      "import": "./dist/extractor/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    },
+    "./validation-schemas": {
+      "types": "./dist/validation-schemas/index.d.ts",
+      "import": "./dist/validation-schemas/index.js"
+    },
+    "./taxonomy": {
+      "types": "./dist/taxonomy/index.d.ts",
+      "import": "./dist/taxonomy/index.js"
+    },
+    "./validation": {
+      "types": "./dist/validation/index.d.ts",
+      "import": "./dist/validation/index.js"
+    },
+    "./package.json": "./package.json",
+    "./mcp": {
+      "types": "./dist/mcp/index.d.ts",
+      "import": "./dist/mcp/index.js"
+    }
+  },
+  "bin": {
+    "architect": "./dist/cli/process-api.js",
+    "architect-generate": "./dist/cli/generate-docs.js",
+    "architect-lint-patterns": "./dist/cli/lint-patterns.js",
+    "architect-guard": "./dist/cli/lint-process.js",
+    "architect-validate": "./dist/cli/validate-patterns.js",
+    "architect-lint-steps": "./dist/cli/lint-steps.js",
+    "architect-mcp": "./dist/cli/mcp-server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist *.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src tests",
+    "lint:fix": "eslint src tests --fix",
+    "architect:guard": "tsx src/cli/lint-process.ts --staged",
+    "architect:guard:all": "tsx src/cli/lint-process.ts --all",
+    "architect:lint-steps": "tsx src/cli/lint-steps.ts",
+    "architect:lint-patterns": "tsx src/cli/lint-patterns.ts --input 'src/**/*.ts' --input 'architect/stubs/**/*.ts'",
+    "validate:patterns": "tsx src/cli/validate-patterns.ts",
+    "validate:dod": "tsx src/cli/validate-patterns.ts --dod",
+    "validate:anti-patterns": "tsx src/cli/validate-patterns.ts --anti-patterns",
+    "validate:all": "tsx src/cli/validate-patterns.ts --dod --anti-patterns",
+    "docs:patterns": "tsx src/cli/generate-docs.ts -g patterns",
+    "docs:roadmap": "tsx src/cli/generate-docs.ts -g roadmap",
+    "docs:remaining": "tsx src/cli/generate-docs.ts -g remaining",
+    "docs:changelog": "tsx src/cli/generate-docs.ts -g changelog",
+    "docs:architecture": "tsx src/cli/generate-docs.ts -g architecture",
+    "docs:decisions": "tsx src/cli/generate-docs.ts -g adrs",
+    "docs:taxonomy": "tsx src/cli/generate-docs.ts -g taxonomy",
+    "docs:validation": "tsx src/cli/generate-docs.ts -g validation-rules",
+    "docs:requirements": "tsx src/cli/generate-docs.ts -g requirements",
+    "docs:current": "tsx src/cli/generate-docs.ts -g current",
+    "docs:milestones": "tsx src/cli/generate-docs.ts -g milestones",
+    "docs:business-rules": "tsx src/cli/generate-docs.ts -g business-rules",
+    "docs:reference": "tsx src/cli/generate-docs.ts -g reference-docs",
+    "docs:product-areas": "tsx src/cli/generate-docs.ts -g product-area-docs",
+    "docs:claude-modules": "tsx src/cli/generate-docs.ts -g claude-modules",
+    "docs:process-api-reference": "tsx src/cli/generate-docs.ts -g process-api-reference",
+    "docs:cli-recipe": "tsx src/cli/generate-docs.ts -g cli-recipe",
+    "docs:index": "tsx src/cli/generate-docs.ts -g index",
+    "docs:design-review": "tsx src/cli/generate-docs.ts -g design-review",
+    "docs:all": "pnpm docs:decisions && pnpm docs:product-areas && pnpm docs:taxonomy && pnpm docs:business-rules && pnpm docs:validation && pnpm docs:reference && pnpm docs:claude-modules && pnpm docs:process-api-reference && pnpm docs:cli-recipe && pnpm docs:architecture && pnpm docs:changelog && pnpm docs:design-review && pnpm docs:index",
+    "docs:all-preview": "pnpm docs:patterns && pnpm docs:roadmap && pnpm docs:remaining && pnpm docs:changelog && pnpm docs:architecture && pnpm docs:decisions && pnpm docs:reference && pnpm docs:product-areas && pnpm docs:taxonomy && pnpm docs:validation && pnpm docs:requirements && pnpm docs:current && pnpm docs:milestones && pnpm docs:business-rules",
+    "architect:query": "tsx src/cli/process-api.ts",
+    "architect:q": "tsx src/cli/process-api.ts",
+    "format": "prettier --write \"src/**/*.ts\" \"tests/**/*.ts\" \"*.{json,md,yml}\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"tests/**/*.ts\" \"*.{json,md,yml}\"",
+    "preversion": "pnpm test && pnpm typecheck && pnpm lint && pnpm format:check",
+    "prepublishOnly": "pnpm build && pnpm test && pnpm typecheck && pnpm lint",
+    "postversion": "git push && git push --tags",
+    "release:pre": "npm version prerelease --preid=pre",
+    "release:patch": "npm version patch",
+    "release:minor": "npm version minor",
+    "release:major": "npm version major",
+    "prepare": "husky",
+    "session:stats": "bash scripts/session-stats.sh",
+    "pr:comments": "node scripts/fetch-pr-comments.mjs",
+    "pr:comments:default": "node scripts/fetch-pr-comments.mjs --type thread",
+    "claude-md:build": "modular-claude-md build",
+    "claude-md:validate": "modular-claude-md validate",
+    "claude-md:info": "modular-claude-md info",
+    "claude-md:additive": "modular-claude-md additive",
+    "claude-md:manifest": "modular-claude-md manifest",
+    "claude-md:all": "pnpm claude-md:build && pnpm claude-md:additive && pnpm claude-md:manifest",
+    "claude:api": "CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir .claude-layers/api-reference",
+    "claude:meta": "CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir .claude-layers/meta",
+    "claude:full": "CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 claude --add-dir .claude-layers/api-reference --add-dir .claude-layers/meta"
+  },
+  "keywords": [
+    "context-engineering",
+    "ai-context",
+    "llm-context",
+    "agentic-context",
+    "ai-assisted-development",
+    "ai-coding",
+    "claude-code",
+    "cursor-ai",
+    "structured-specs",
+    "source-first",
+    "code-first",
+    "docs-as-code",
+    "living-documentation",
+    "documentation-generator",
+    "technical-documentation",
+    "architect",
+    "libar-architect",
+    "workflow-enforcement",
+    "fsm-enforcement",
+    "pre-commit-hooks",
+    "git-hooks",
+    "architecture-graph",
+    "dependency-graph",
+    "mermaid",
+    "traceability",
+    "dual-source",
+    "master-dataset",
+    "gherkin",
+    "bdd",
+    "typescript-annotations",
+    "roadmap",
+    "cli"
+  ],
+  "author": "Libar AI",
+  "license": "(MIT AND BUSL-1.1)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/libar-dev/delivery-process.git"
+  },
+  "bugs": {
+    "url": "https://github.com/libar-dev/delivery-process/issues"
+  },
+  "homepage": "https://github.com/libar-dev/delivery-process#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@cucumber/gherkin": "^29.0.0",
+    "@cucumber/messages": "^25.0.1",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@typescript-eslint/typescript-estree": "^8.18.0",
+    "chokidar": "^5.0.0",
+    "glob": "^10.3.10",
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "@amiceli/vitest-cucumber": "^5.2.1",
+    "@libar-dev/modular-claude-md": "github:libar-dev/modular-claude-md#3a37c573ae8611f1e0e92c00f565bb0ab45e1263",
+    "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^2.1.9",
+    "eslint": "^9.17.0",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "tsx": "^4.7.0",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.18.2",
+    "vitest": "^2.1.8"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "docs-live",
+    "README.md",
+    "LICENSE",
+    "LICENSE-MCP",
+    "CHANGELOG.md"
+  ],
+  "private": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "pre"
+  },
+  "lint-staged": {
+    "{src,tests}/**/*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ],
+    "*.{json,md,yml,yaml}": [
+      "prettier --write"
+    ]
+  }
+}