engimcp 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+## Unreleased
+
+## 1.0.0 - 2026-07-01
+
+### Added
+
+- Added a TypeScript MCP server skeleton with stdio transport and structured tool registration.
+- Added project initialization, status, project map, document read/create, frontmatter patch, section patch, and relationship tools.
+- Added requirements, engineering decisions, tasks, test reports, BOM item creation, validation, graph query, impact analysis, context pack, search, Git status, snapshot, Git commit, and index rebuild tools.
+- Added explicit MCP output schemas for all registered tools.
+- Added the safe project filesystem layer: `engi_fs_tree`, `engi_fs_list`, `engi_fs_read`, `engi_fs_write`, `engi_fs_mkdir`, `engi_fs_move`, `engi_fs_copy`, `engi_fs_delete`, `engi_fs_exists`, `engi_fs_stat`, and `engi_fs_glob`.
+- Added project trash semantics for safe delete operations under `.engimcp/trash/YYYY-MM-DD/<original-path>`.
+- Added project-configured deny patterns on top of default deny patterns.
+- Added runtime `--read-only` and `--root` options for server startup.
+- Added search filters for kind, status, tags, and exact frontmatter fields.
+- Added derived SQLite index restore when opening a project with a missing index.
+- Added an expanded radio-controlled car example covering requirements, motors, battery, transmission, calculations, tests, BOM, and EDR impact scenarios.
+
+### Changed
+
+- Filesystem write, mkdir, move, copy, and delete operations now rebuild the derived index after successful changes.
+- Managed document move/delete operations now report incoming and outgoing link impact.
+- Moving files with `update_links=true` updates safe internal Markdown/wiki-style path links.
+- Copying managed documents now runs validation so duplicate IDs are reported.
+- `engi_project_map` now honors `max_depth`.
+- `context_pack` now expands task-term matches through graph neighbors and records combined inclusion reasons.
+- `impact_analyze` now treats `impacts` edges bidirectionally for change-impact discovery.
+- Documentation now distinguishes `engi_doc_*` managed engineering document semantics from `engi_fs_*` ordinary file/folder semantics.
+
+### Security
+
+- Filesystem operations are root-jailed to `project_root`, reject traversal and symlink escape, enforce deny patterns, and block write-like actions in read-only mode.
+- Overwrite-like operations refuse to modify files containing Git conflict markers.
+- Delete defaults to trash mode; permanent delete is not part of the MVP.
+- Write-like filesystem operations write audit log entries.
+
+### Tests
+
+- Added milestone and completion tests for project init/read/index/validate, document writes, graph/impact, requirements/EDR/tasks, context pack, Git integration, v1 stabilization, security, and filesystem layer behavior.
+- Added acceptance coverage for motor-change context packs and battery-change impact analysis.
+- Added smoke run through `npm run smoke`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EngiMCP contributors
+
+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/README.md

@@ -0,0 +1,345 @@
+---
+id: README
+kind: overview
+status: draft
+version: 1.0.0
+---
+
+# EngiMCP
+
+EngiMCP is a local MCP server for managing engineering projects stored as Markdown, YAML frontmatter, and Git history. It gives an LLM agent structured, safe access to requirements, engineering decisions, calculations, tests, tasks, BOM items, document relationships, impact analysis, context packs, and ordinary project files.
+
+The source of truth stays in the project folder. The SQLite index under `.engimcp/index.sqlite` is derived data and can be rebuilt.
+
+## Why It Exists
+
+Long-running engineering work cannot live only in chat. Requirements drift, decisions get forgotten, tests stop matching design assumptions, and documents become inconsistent.
+
+Codex is strong at inspecting and changing code repositories, but engineering documentation needs a domain layer on top of files. EngiMCP exposes IDs, document kinds, frontmatter, links, graph relationships, validation, impact analysis, and focused writes so the agent can answer questions such as:
+
+```text
+What breaks if we change the battery?
+Prepare context for changing the project motors.
+Create an EDR for this design choice.
+Find requirements that are not verified by tests.
+```
+
+## Requirements
+
+- Node.js 20 or newer.
+- npm.
+- Git, for Git status/snapshot/commit workflows.
+- An MCP-compatible client such as Codex, Claude Code, or another local MCP client.
+
+## User Guide
+
+EngiMCP is meant to be used through an MCP client. In normal use, you do not call TypeScript code directly. You start the server, connect it to your agent, and then ask the agent engineering-project questions in plain language.
+
+### 1. Prepare an Engineering Project Folder
+
+Choose or create a local folder for the project:
+
+```bash
+mkdir -p ~/Work/Projects/RC-Car
+cd ~/Work/Projects/RC-Car
+git init
+```
+
+EngiMCP will keep the source of truth in this folder as Markdown files plus `project.yaml`.
+
+### 2. Install and Build EngiMCP
+
+From the EngiMCP repository:
+
+```bash
+npm install
+npm run build
+```
+
+### 3. Connect It to an MCP Client
+
+Use the built server command in your MCP client configuration:
+
+```text
+node /absolute/path/to/EngiMCP/dist/index.js --root /absolute/path/to/your/project
+```
+
+For a read-only review session:
+
+```text
+node /absolute/path/to/EngiMCP/dist/index.js --root /absolute/path/to/your/project --read-only
+```
+
+After package installation, the binary form is:
+
+```text
+engimcp --root /absolute/path/to/project
+engimcp --root /absolute/path/to/project --read-only
+```
+
+When `--root` is set, tool calls must use that same project root. When `--read-only` is set, write-like tools are rejected.
+
+### 4. Initialize the Project
+
+Ask your agent:
+
+```text
+Initialize this folder as an EngiMCP project.
+```
+
+The agent should call:
+
+```text
+engi_project_init(root="/absolute/path/to/project")
+```
+
+This creates the basic project files:
+
+```text
+project.yaml
+docs/
+templates/
+.engimcp/
+```
+
+### 5. Start Working
+
+Useful first prompts:
+
+```text
+Show project status.
+Create a requirement: the car must run for 30 minutes.
+Create an engineering decision for using four geared motors.
+What breaks if we change the battery?
+Prepare context for changing the project motors.
+Find requirements that are not verified by tests.
+Validate the project and show what needs fixing.
+Show the Git diff summary.
+```
+
+The agent will use EngiMCP tools to read the right documents, build context, analyze links, and apply focused edits.
+
+## Common User Workflows
+
+### Create Requirements
+
+Ask:
+
+```text
+Add a requirement that the radio-controlled car must stop safely when radio control is lost.
+```
+
+EngiMCP creates a managed Markdown requirement with an ID such as `FR-001`, `NFR-001`, `SEC-001`, or `AC-001`.
+
+### Record Engineering Decisions
+
+Ask:
+
+```text
+Create an EDR explaining why we selected a 2S LiPo battery.
+```
+
+EngiMCP creates an Engineering Decision Record such as `EDR-0001` with context, options, decision, consequences, and links.
+
+### Analyze Change Impact
+
+Ask:
+
+```text
+What documents, tests, BOM items, and decisions are affected if we change the battery?
+```
+
+EngiMCP follows frontmatter links and inline links to return direct and transitive impact.
+
+### Prepare Focused Context
+
+Ask:
+
+```text
+Prepare context for changing the drive motors.
+```
+
+EngiMCP builds a compact context pack instead of forcing the agent to read the whole project.
+
+### Edit Documents Safely
+
+Ask:
+
+```text
+Update the Battery Estimate section with the new runtime calculation.
+```
+
+The agent should use section-level document tools, so the edit stays focused and reviewable in Git.
+
+### Work with Ordinary Files
+
+Ask:
+
+```text
+List files under docs.
+Read docs/battery-notes.md.
+Create a folder for test reports.
+Move this draft file into docs/archive.
+Delete this temporary note.
+```
+
+EngiMCP uses the safe `engi_fs_*` layer. Deletes go to `.engimcp/trash/...` by default.
+
+## Project Format
+
+A valid project has:
+
+```text
+project.yaml
+docs/
+templates/
+.engimcp/
+```
+
+Managed Markdown documents use YAML frontmatter with at least:
+
+```yaml
+---
+id: DOC-EXAMPLE
+kind: design_doc
+status: draft
+version: 0.1.0
+---
+```
+
+You can edit Markdown files manually in VS Code, Obsidian, or another editor. Run validation after manual edits:
+
+```text
+Validate the project.
+```
+
+## Quick Start
+
+1. Start the MCP server from this repository or install it as a binary.
+2. Connect an MCP client over stdio.
+3. Initialize or open a project root.
+4. Call `engi_project_status` to verify the project.
+5. Use `engi_context_pack` before asking the agent to change a subsystem.
+6. Use `engi_impact_analyze` before changing requirements, decisions, battery, motors, BOM, tests, or calculations.
+7. Use `engi_validate_project` after changes.
+8. Review the Git diff with `engi_git_status`.
+
+Example workflow:
+
+```text
+engi_project_status(root)
+engi_context_pack(root, task="we are changing the project motors")
+engi_impact_analyze(root, changed_ids=["DOC-RC-CAR-BATTERY"])
+engi_doc_patch_section(root, id="DOC-RC-CAR-BATTERY", heading_path=["Initial Estimate"], ...)
+engi_validate_project(root)
+engi_git_status(root)
+```
+
+## Core Tools
+
+Project:
+
+- `engi_project_init`
+- `engi_project_status`
+- `engi_project_map`
+- `engi_rebuild_index`
+
+Managed engineering documents:
+
+- `engi_doc_read`
+- `engi_doc_create`
+- `engi_frontmatter_patch`
+- `engi_doc_patch_section`
+- `engi_doc_add_relationship`
+
+Engineering entities:
+
+- `engi_requirement_create`
+- `engi_decision_create`
+- `engi_task_create`
+- `engi_test_report_create`
+- `engi_bom_item_create`
+
+Analysis and retrieval:
+
+- `engi_search`
+- `engi_graph_query`
+- `engi_impact_analyze`
+- `engi_context_pack`
+- `engi_validate_project`
+
+Git:
+
+- `engi_git_status`
+- `engi_project_snapshot`
+- `engi_git_commit`
+
+Safe filesystem layer:
+
+- `engi_fs_tree`
+- `engi_fs_list`
+- `engi_fs_read`
+- `engi_fs_write`
+- `engi_fs_mkdir`
+- `engi_fs_move`
+- `engi_fs_copy`
+- `engi_fs_delete`
+- `engi_fs_exists`
+- `engi_fs_stat`
+- `engi_fs_glob`
+
+Use `engi_doc_*` for managed engineering documents where IDs, frontmatter, links, graph, and validation matter. Use `engi_fs_*` for ordinary files and folders inside the project root.
+
+## Safety Model
+
+EngiMCP is not raw filesystem access.
+
+- All operations are restricted to `project_root`.
+- Runtime `--root` pins the allowed project root.
+- `../` traversal and absolute-path escape are rejected.
+- Symlink escape outside the root is rejected.
+- Deny patterns block `.git`, `.env`, SSH keys, secrets, private files, cache paths, and dependency folders.
+- Project-configured deny patterns extend the defaults.
+- Write-like tools respect read-only mode.
+- Deletes use trash by default: `.engimcp/trash/YYYY-MM-DD/<original-path>`.
+- Writes are atomic where practical.
+- Write/move/copy/delete/mkdir operations write audit log entries.
+- Overwrite-like operations refuse to modify files containing Git conflict markers.
+
+## Validation and Indexing
+
+`engi_validate_project` checks IDs, required frontmatter, duplicate IDs, broken links, dependency cycles, and requirement verification gaps.
+
+`engi_rebuild_index` regenerates `.engimcp/index.sqlite` from Markdown and frontmatter. Filesystem write-like operations rebuild the index after successful changes, and `engi_project_status` restores the index if it is missing.
+
+## Development Commands
+
+```bash
+npm run build
+npm run lint
+npm run format
+npm run format:check
+npm test
+npm run check
+npm run smoke
+```
+
+`npm run check` runs build, lint, format check, and the test suite. `npm run smoke` builds the project and runs a project-status smoke check against the radio-controlled car example.
+
+## Important Documentation
+
+- `docs/02_requirements/technical_requirements.md` - functional and non-functional requirements.
+- `docs/02_requirements/filesystem_overlay_requirements.md` - safe filesystem layer requirements.
+- `docs/02_requirements/acceptance_criteria.md` - acceptance criteria.
+- `docs/03_architecture/system_architecture.md` - system architecture.
+- `docs/04_data_model/entities_and_schema.md` - entity and frontmatter model.
+- `docs/05_mcp_interface/tools_spec.md` - MCP tool contracts.
+- `docs/05_mcp_interface/filesystem_tools_spec.md` - filesystem tool contracts.
+- `docs/07_quality/testing_strategy.md` - test strategy.
+- `docs/08_security/security_model.md` - security model.
+- `docs/09_delivery/roadmap.md` - milestone roadmap.
+- `CHANGELOG.md` - release notes.
+
+## License
+
+MIT.

package/dist/audit/auditLog.d.ts

@@ -0,0 +1,9 @@
+export interface AuditLogInput {
+    root: string;
+    tool: string;
+    target: string;
+    operation: string;
+    result: "ok" | "error";
+    diff_summary: string;
+}
+export declare function writeAuditLog(input: AuditLogInput): Promise<string>;

package/dist/audit/auditLog.js

@@ -0,0 +1,20 @@
+import { mkdir, appendFile } from "node:fs/promises";
+import path from "node:path";
+export async function writeAuditLog(input) {
+    const auditId = `AUD-${new Date().toISOString().replace(/[-:.TZ]/g, "")}`;
+    const auditDirectory = path.join(input.root, ".engimcp");
+    const auditPath = path.join(auditDirectory, "audit.log");
+    const record = {
+        id: auditId,
+        ts: new Date().toISOString(),
+        tool: input.tool,
+        target: input.target,
+        operation: input.operation,
+        result: input.result,
+        diff_summary: input.diff_summary
+    };
+    await mkdir(auditDirectory, { recursive: true });
+    await appendFile(auditPath, `${JSON.stringify(record)}\n`, "utf8");
+    return auditId;
+}
+//# sourceMappingURL=auditLog.js.map

package/dist/audit/auditLog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auditLog.js","sourceRoot":"","sources":["../../src/audit/auditLog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,IAAI,MAAM,WAAW,CAAC;AAW7B,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAoB;IACtD,MAAM,OAAO,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC;IAC1E,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG;QACb,EAAE,EAAE,OAAO;QACX,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,KAAK,CAAC,YAAY;KACjC,CAAC;IAEF,MAAM,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,MAAM,UAAU,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEnE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/bom/bomService.d.ts

@@ -0,0 +1,23 @@
+export interface CreateBomItemInput {
+    root: string;
+    id: string;
+    part_name: string;
+    quantity: number;
+    status?: "candidate" | "approved" | "rejected";
+    source?: string;
+    unit_cost?: number;
+    currency?: string;
+    related?: string[];
+    dry_run?: boolean;
+}
+export declare function createBomItem(input: CreateBomItemInput): Promise<{
+    id: string;
+    path: string;
+    content: string;
+    audit_id?: undefined;
+} | {
+    id: string;
+    path: string;
+    audit_id: string;
+    content?: undefined;
+}>;

package/dist/bom/bomService.js

@@ -0,0 +1,44 @@
+import { writeAuditLog } from "../audit/auditLog.js";
+import { serializeDocument } from "../documents/frontmatter.js";
+import { assertAbsoluteRoot, resolveSafePath } from "../project/pathSafety.js";
+import { assertProjectWritable } from "../project/writeGuards.js";
+import { atomicWrite } from "../utils/atomicWrite.js";
+import { slugify } from "../utils/ids.js";
+export async function createBomItem(input) {
+    const root = assertAbsoluteRoot(input.root);
+    await assertProjectWritable(root);
+    const relativePath = `docs/bom/${input.id}-${slugify(input.part_name)}.md`;
+    const content = serializeDocument({
+        id: input.id,
+        kind: "bom_item",
+        status: input.status ?? "candidate",
+        version: "0.1.0",
+        part_name: input.part_name,
+        quantity: input.quantity,
+        source: input.source,
+        unit_cost: input.unit_cost,
+        currency: input.currency,
+        relates_to: input.related ?? []
+    }, `# ${input.id}: ${input.part_name}
+
+| Field | Value |
+|---|---|
+| Quantity | ${input.quantity} |
+| Status | ${input.status ?? "candidate"} |
+| Source | ${input.source ?? ""} |
+`);
+    if (input.dry_run) {
+        return { id: input.id, path: relativePath, content };
+    }
+    await atomicWrite(await resolveSafePath(root, relativePath), content);
+    const auditId = await writeAuditLog({
+        root,
+        tool: "engi_bom_item_create",
+        target: input.id,
+        operation: "create",
+        result: "ok",
+        diff_summary: "BOM item created"
+    });
+    return { id: input.id, path: relativePath, audit_id: auditId };
+}
+//# sourceMappingURL=bomService.js.map

package/dist/bom/bomService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bomService.js","sourceRoot":"","sources":["../../src/bom/bomService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAe1C,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAyB;IAC3D,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,YAAY,GAAG,YAAY,KAAK,CAAC,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC;IAC3E,MAAM,OAAO,GAAG,iBAAiB,CAC/B;QACE,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,WAAW;QACnC,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,UAAU,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;KAChC,EACD,KAAK,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,SAAS;;;;eAItB,KAAK,CAAC,QAAQ;aAChB,KAAK,CAAC,MAAM,IAAI,WAAW;aAC3B,KAAK,CAAC,MAAM,IAAI,EAAE;CAC9B,CACE,CAAC;IAEF,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,WAAW,CAAC,MAAM,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC;QAClC,IAAI;QACJ,IAAI,EAAE,sBAAsB;QAC5B,MAAM,EAAE,KAAK,CAAC,EAAE;QAChB,SAAS,EAAE,QAAQ;QACnB,MAAM,EAAE,IAAI;QACZ,YAAY,EAAE,kBAAkB;KACjC,CAAC,CAAC;IAEH,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACjE,CAAC"}

package/dist/config/projectConfig.d.ts

@@ -0,0 +1,16 @@
+export interface EngiProjectConfig {
+    project: {
+        id: string;
+        name?: string;
+        schema_version?: string;
+        source_of_truth?: string;
+    };
+    mcp?: {
+        read_only_mode?: boolean;
+    };
+    security?: {
+        deny_patterns?: string[];
+        follow_symlinks?: boolean;
+    };
+}
+export declare function readProjectConfig(root: string): Promise<EngiProjectConfig>;

package/dist/config/projectConfig.js

@@ -0,0 +1,16 @@
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+import { parse } from "yaml";
+import { EngiMcpError } from "../mcp/errors.js";
+import { projectConfigSchema } from "./schema.js";
+export async function readProjectConfig(root) {
+    const configPath = path.join(root, "project.yaml");
+    await access(configPath);
+    const parsed = parse(await readFile(configPath, "utf8"));
+    const config = projectConfigSchema.parse(parsed);
+    if (config.project.schema_version !== "1.0.0") {
+        throw new EngiMcpError("UNSUPPORTED_SCHEMA_VERSION", `Unsupported project schema_version ${config.project.schema_version}; expected 1.0.0. Run a project migration before opening this project.`);
+    }
+    return config;
+}
+//# sourceMappingURL=projectConfig.js.map

package/dist/config/projectConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectConfig.js","sourceRoot":"","sources":["../../src/config/projectConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAkBlD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IACnD,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAEzB,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAY,CAAC;IACpE,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,KAAK,OAAO,EAAE,CAAC;QAC9C,MAAM,IAAI,YAAY,CACpB,4BAA4B,EAC5B,sCAAsC,MAAM,CAAC,OAAO,CAAC,cAAc,wEAAwE,CAC5I,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/config/schema.d.ts

@@ -0,0 +1,16 @@
+import { z } from "zod";
+export declare const projectConfigSchema: z.ZodObject<{
+    project: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        schema_version: z.ZodDefault<z.ZodString>;
+        source_of_truth: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    mcp: z.ZodOptional<z.ZodObject<{
+        read_only_mode: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    security: z.ZodOptional<z.ZodObject<{
+        deny_patterns: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        follow_symlinks: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;

package/dist/config/schema.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export const projectConfigSchema = z.object({
+    project: z.object({
+        id: z.string(),
+        name: z.string().optional(),
+        schema_version: z.string().default("1.0.0"),
+        source_of_truth: z.string().optional()
+    }),
+    mcp: z
+        .object({
+        read_only_mode: z.boolean().default(false)
+    })
+        .optional(),
+    security: z
+        .object({
+        deny_patterns: z.array(z.string()).optional(),
+        follow_symlinks: z.boolean().default(false)
+    })
+        .optional()
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACvC,CAAC;IACF,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KAC3C,CAAC;SACD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;QAC7C,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KAC5C,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC"}

package/dist/context/contextPack.d.ts

@@ -0,0 +1,31 @@
+export interface ContextPackInput {
+    root: string;
+    task: string;
+    seed_ids?: string[];
+    max_tokens?: number;
+    include_sections?: boolean;
+    include_decisions?: boolean;
+    include_open_tasks?: boolean;
+    include_validation?: boolean;
+}
+export interface ContextPackItem {
+    id?: string;
+    path: string;
+    kind?: string;
+    reason: string;
+    content_mode: "full" | "section";
+    content: string;
+}
+export interface ContextPackResult {
+    pack_id: string;
+    task: string;
+    estimated_tokens: number;
+    items: ContextPackItem[];
+    excluded: Array<{
+        id?: string;
+        path: string;
+        reason: string;
+    }>;
+    warnings: string[];
+}
+export declare function buildContextPack(input: ContextPackInput): Promise<ContextPackResult>;