@libar-dev/architect 1.0.0-pre.3

package/CHANGELOG.md

@@ -0,0 +1,50 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [1.0.0-pre.3] - 2026-03-27
+
+First publication as `@libar-dev/architect` (renamed from `@libar-dev/delivery-process`).
+
+### Changed
+
+- Package renamed from `@libar-dev/delivery-process` to `@libar-dev/architect`
+- All annotation prefixes changed from `@libar-docs-*` to `@architect-*`
+- CLI bin entries renamed: `process-api` → `architect`, `lint-process` → `architect-guard`, etc.
+- MCP server tools renamed to `architect_*` prefix (25 tools)
+- Configuration file renamed to `architect.config.ts`
+
+### Added
+
+- MCP server with 25 tools, stdio transport, file watcher, sub-millisecond dispatch
+- `@modelcontextprotocol/sdk` and `chokidar` dependencies for MCP server
+- BSL 1.1 license for `src/mcp/` directory (LICENSE-MCP)
+
+## [1.0.0-pre.0] - 2026-02-21
+
+First npm-published pre-release for monorepo validation.
+
+### Added
+
+- Stable public API with 12 subpath exports (including new `./api`)
+- Process Data API with 27 CLI subcommands for AI-native delivery state queries
+- FSM-enforced workflow validation via pre-commit hooks
+- Codec-based document generation (patterns, roadmap, decisions, product areas, etc.)
+- Cross-source validation (TypeScript + Gherkin dual-source merging)
+- MasterDataset single read model (ADR-006)
+
+### Changed
+
+- Published to npm registry (previously consumed via `git+https://` only)
+- `dist/` removed from git tracking -- built fresh during publish
+- `@libar-dev/modular-claude-md` moved from dependencies to devDependencies
+- Package size trimmed (removed self-referential docs from tarball)
+
+[Unreleased]: https://github.com/libar-dev/delivery-process/compare/v1.0.0-pre.3...HEAD
+[1.0.0-pre.3]: https://github.com/libar-dev/delivery-process/compare/v1.0.0-pre.0...v1.0.0-pre.3
+[1.0.0-pre.0]: https://github.com/libar-dev/delivery-process/releases/tag/v1.0.0-pre.0

package/LICENSE

@@ -0,0 +1,25 @@
+This MIT license applies to all files in this repository EXCEPT those in the
+src/mcp/ directory, which are licensed under the Business Source License 1.1
+(see LICENSE-MCP).
+
+MIT License
+
+Copyright (c) 2024-2026 libar-dev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSE-MCP

@@ -0,0 +1,62 @@
+Business Source License 1.1
+
+Parameters
+
+Licensor:             EBIZ d.o.o.
+Licensed Work:        The files in the src/mcp/ directory of the Architect
+                      software. The Licensed Work is (c) 2026 EBIZ d.o.o.
+Additional Use Grant: You may use the Licensed Work for internal development
+                      purposes, including using the MCP server tools for
+                      querying project data. You may not redistribute the
+                      Licensed Work as part of a competing commercial product
+                      that provides MCP-based project context tools.
+Change Date:          2030-03-14
+Change License:       MIT License
+
+For information about alternative licensing arrangements for the Licensed Work,
+please contact licensing@libar.ai.
+
+Notice
+
+Business Source License 1.1
+
+Terms
+
+The Licensor hereby grants you the right to copy, modify, create derivative
+works, redistribute, and make non-production use of the Licensed Work. The
+Licensor may make an Additional Use Grant, above, permitting limited production
+use.
+
+Effective on the Change Date, or the fourth anniversary of the first publicly
+available distribution of a specific version of the Licensed Work under this
+License, whichever comes first, the Licensor hereby grants you rights under the
+terms of the Change License, and the rights granted in the paragraph above
+terminate.
+
+If your use of the Licensed Work does not comply with the requirements currently
+in effect as described in this License, you must purchase a commercial license
+from the Licensor, its affiliated entities, or authorized resellers, or you must
+refrain from using the Licensed Work.
+
+All copies of the original and modified Licensed Work, and derivative works of
+the Licensed Work, are subject to this License. This License applies separately
+for each version of the Licensed Work and the Change Date may vary for each
+version of the Licensed Work released by Licensor.
+
+You must conspicuously display this License on each original or modified copy of
+the Licensed Work. If you receive the Licensed Work in original or modified form
+from a third party, the terms and conditions set forth in this License apply to
+your use of that work.
+
+Any use of the Licensed Work in violation of this License will automatically
+terminate your rights under this License for the current and all other versions
+of the Licensed Work.
+
+This License does not grant you any right in any trademark or logo of Licensor
+or its affiliates (provided that you may use a trademark or logo of Licensor as
+expressly required by this License).
+
+TO THE EXTENT PERMITTED BY APPLICABLE LAW, THE LICENSED WORK IS PROVIDED ON AN
+"AS IS" BASIS. LICENSOR HEREBY DISCLAIMS ALL WARRANTIES AND CONDITIONS, EXPRESS
+OR IMPLIED, INCLUDING (WITHOUT LIMITATION) WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, AND TITLE.

package/README.md

@@ -0,0 +1,147 @@
+# @libar-dev/architect
+
+**Context engineering for AI-assisted codebases.**
+
+Turn TypeScript annotations and Gherkin specs into a **structured, queryable delivery state** — living documentation, architecture graphs, and FSM-enforced workflows that AI agents consume without hallucinating.
+
+[![npm version](https://img.shields.io/npm/v/@libar-dev/architect.svg)](https://www.npmjs.com/package/@libar-dev/architect)
+[![Build Status](https://github.com/libar-dev/delivery-process/workflows/CI/badge.svg)](https://github.com/libar-dev/delivery-process/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/@libar-dev/architect.svg)](https://nodejs.org/)
+
+---
+
+## Why This Exists
+
+AI coding agents need architectural context to generate correct code. This package makes **code the single source of truth** for both humans and machines — annotations in code and Gherkin specs replace manually maintained docs that drift out of date.
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+# npm
+npm install @libar-dev/architect@pre
+
+# pnpm (recommended)
+pnpm add @libar-dev/architect@pre
+```
+
+**Requirements:** Node.js >= 18.0.0, ESM project (`"type": "module"` in package.json)
+
+### 2. Annotate Your Code
+
+```typescript
+/** @architect */
+
+/**
+ * @architect-pattern UserAuthentication
+ * @architect-status roadmap
+ * @architect-uses SessionManager, TokenValidator
+ *
+ * ## User Authentication
+ *
+ * Handles user login, logout, and session management.
+ */
+export class UserAuthentication {
+  // ...
+}
+```
+
+> Tag prefix is configurable. The default `libar-generic` preset uses `@architect-*` (shown above). See [docs/CONFIGURATION.md](docs/CONFIGURATION.md).
+
+### 3. Generate Documentation
+
+```bash
+npx architect-generate -g patterns -i "src/**/*.ts" -o docs -f
+```
+
+### 4. Enforce Workflow (Pre-commit Hook)
+
+```bash
+npx architect-guard --staged
+```
+
+This validates FSM transitions and blocks invalid status changes.
+
+---
+
+## How It Works
+
+**TypeScript annotations** define pattern metadata and relationships:
+
+```typescript
+/**
+ * @architect
+ * @architect-pattern TransformDataset
+ * @architect-status completed
+ * @architect-uses MasterDataset, ExtractedPattern, TagRegistry
+ */
+export function transformToMasterDataset(input: TransformInput): MasterDataset {
+  // ...
+}
+```
+
+**Gherkin feature files** own planning metadata (status, phase, deliverables). The generator merges both sources into a unified MasterDataset.
+
+**Pipeline:** `Config → Scanner → Extractor → Transformer → Codec` — files become patterns, patterns become a MasterDataset, the MasterDataset renders to Markdown and JSON.
+
+---
+
+## What Gets Generated
+
+All output goes to [`docs-live/`](docs-live/INDEX.md) — 57+ auto-generated files from annotated source code:
+
+| Output                            | Files | Source                                                    |
+| --------------------------------- | ----: | --------------------------------------------------------- |
+| **Product area docs**             |     7 | `@architect-uses`, `@architect-status`, relationship tags |
+| **Business rules**                |     7 | Gherkin `Rule:` Invariant/Rationale blocks                |
+| **Architecture decisions (ADRs)** |     7 | Decision feature files                                    |
+| **Reference guides**              |     8 | CLI schema, codec patterns, annotations                   |
+| **Live Mermaid diagrams**         |     — | `@architect-uses`, `@architect-depends-on` relationships  |
+| **API type shapes**               |     — | `@architect-shape` on TypeScript declarations             |
+| **Validation rules**              |     3 | Process Guard FSM specs                                   |
+| **Taxonomy reference**            |     3 | Tag registry                                              |
+| **AI context modules**            |    13 | `@architect-claude-module` tagged specs                   |
+| **Changelog**                     |     1 | Release specs                                             |
+
+**Browse it:** [`docs-live/INDEX.md`](docs-live/INDEX.md) is the navigation hub with reading order, document roles, and product area statistics.
+
+---
+
+## CLI Commands
+
+| Command                   | Purpose                                                | Docs                                                                      |
+| ------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------- |
+| `architect-generate`      | Generate documentation from annotated sources          | `architect-generate --help`                                               |
+| `architect`               | Query delivery state for AI coding sessions            | [Process API Reference](docs-live/reference/PROCESS-API-REFERENCE.md)     |
+| `architect-lint-patterns` | Validate annotation quality (missing tags, etc.)       | [Validation Rules](docs-live/VALIDATION-RULES.md)                         |
+| `architect-guard`         | Validate delivery workflow FSM transitions             | [Process Guard Reference](docs-live/reference/PROCESS-GUARD-REFERENCE.md) |
+| `architect-lint-steps`    | Validate vitest-cucumber feature/step compatibility    | [Validation Rules](docs-live/VALIDATION-RULES.md)                         |
+| `architect-validate`      | Cross-source validation with Definition of Done checks | [Validation Rules](docs-live/VALIDATION-RULES.md)                         |
+
+---
+
+## Documentation
+
+### Generated Docs (auto-maintained)
+
+**[`docs-live/INDEX.md`](docs-live/INDEX.md)** is the navigation hub — 57+ files generated from annotated source code, organized into product areas, reference guides, business rules, ADRs, taxonomy, and validation rules.
+
+### Editorial Docs (hand-maintained)
+
+| Document                                        | Focus                          |
+| ----------------------------------------------- | ------------------------------ |
+| [CONFIGURATION.md](docs/CONFIGURATION.md)       | Presets, tags, config files    |
+| [METHODOLOGY.md](docs/METHODOLOGY.md)           | Core thesis, dual-source "why" |
+| [GHERKIN-PATTERNS.md](docs/GHERKIN-PATTERNS.md) | Writing effective specs        |
+| [SESSION-GUIDES.md](docs/SESSION-GUIDES.md)     | Day-to-day AI/dev workflows    |
+| [VALIDATION.md](docs/VALIDATION.md)             | Automated quality checks       |
+
+---
+
+## License
+
+MIT © Libar AI

package/dist/api/arch-queries.d.ts

@@ -0,0 +1,95 @@
+/**
+ * @architect
+ * @architect-pattern ArchQueriesImpl
+ * @architect-status active
+ * @architect-implements DataAPIArchitectureQueries
+ * @architect-uses ProcessStateAPI, MasterDataset
+ * @architect-used-by ProcessAPICLIImpl
+ * @architect-arch-role service
+ * @architect-arch-context api
+ * @architect-arch-layer domain
+ *
+ * ## ArchQueries — Neighborhood, Comparison, Tags, Sources
+ *
+ * Pure functions over MasterDataset for deep architecture exploration.
+ * No I/O — all data comes from pre-computed views.
+ *
+ * **When to Use:** When exploring architecture structure (neighborhoods, comparisons, tags, sources) via the Data API CLI.
+ */
+import type { MasterDataset } from '../validation-schemas/master-dataset.js';
+import type { NeighborEntry } from './types.js';
+export interface NeighborhoodResult {
+    readonly pattern: string;
+    readonly context: string | undefined;
+    readonly role: string | undefined;
+    readonly layer: string | undefined;
+    readonly uses: readonly NeighborEntry[];
+    readonly usedBy: readonly NeighborEntry[];
+    readonly dependsOn: readonly NeighborEntry[];
+    readonly enables: readonly NeighborEntry[];
+    readonly sameContext: readonly NeighborEntry[];
+    readonly implements: readonly string[];
+    readonly implementedBy: readonly string[];
+}
+export interface ContextSummary {
+    readonly name: string;
+    readonly patternCount: number;
+    readonly patterns: readonly string[];
+    readonly allDependencies: readonly string[];
+}
+export interface IntegrationPoint {
+    readonly from: string;
+    readonly fromContext: string;
+    readonly to: string;
+    readonly toContext: string;
+    readonly relationship: string;
+}
+export interface ContextComparison {
+    readonly context1: ContextSummary;
+    readonly context2: ContextSummary;
+    readonly sharedDependencies: readonly string[];
+    readonly uniqueToContext1: readonly string[];
+    readonly uniqueToContext2: readonly string[];
+    readonly integrationPoints: readonly IntegrationPoint[];
+}
+export interface TagValueCount {
+    readonly value: string;
+    readonly count: number;
+}
+export interface TagUsageEntry {
+    readonly tag: string;
+    readonly count: number;
+    readonly values: readonly TagValueCount[] | null;
+}
+export interface TagUsageReport {
+    readonly tags: readonly TagUsageEntry[];
+    readonly patternCount: number;
+}
+export interface SourceTypeEntry {
+    readonly type: string;
+    readonly count: number;
+    readonly locationPattern: string;
+    readonly files: readonly string[];
+}
+export interface SourceInventory {
+    readonly types: readonly SourceTypeEntry[];
+    readonly totalFiles: number;
+}
+export declare function computeNeighborhood(name: string, dataset: MasterDataset): NeighborhoodResult | undefined;
+export declare function compareContexts(ctx1: string, ctx2: string, dataset: MasterDataset): ContextComparison | undefined;
+export declare function aggregateTagUsage(dataset: MasterDataset): TagUsageReport;
+export declare function buildSourceInventory(dataset: MasterDataset): SourceInventory;
+export interface OrphanEntry {
+    readonly pattern: string;
+    readonly status: string | undefined;
+    /** Empty string if pattern metadata is unavailable. */
+    readonly file: string;
+}
+/**
+ * Find patterns with no relationships at all (isolated nodes in the graph).
+ *
+ * A pattern is an orphan if it has no uses, usedBy, dependsOn, enables,
+ * implementsPatterns, implementedBy, extendedBy, seeAlso, or extendsPattern.
+ */
+export declare function findOrphanPatterns(dataset: MasterDataset): readonly OrphanEntry[];
+//# sourceMappingURL=arch-queries.d.ts.map

package/dist/api/arch-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arch-queries.d.ts","sourceRoot":"","sources":["../../src/api/arch-queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkBhD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3C,QAAQ,CAAC,WAAW,EAAE,SAAS,aAAa,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAMD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,iBAAiB,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACzD;AAMD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAMD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAMD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,GACrB,kBAAkB,GAAG,SAAS,CAwChC;AA6DD,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,GACrB,iBAAiB,GAAG,SAAS,CAwD/B;AAMD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CA0CxE;AA4BD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CA4B5E;AAMD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,WAAW,EAAE,CA6BjF"}