ai-docs-toolkit 0.4.2__tar.gz → 0.5.1__tar.gz

{ai_docs_toolkit-0.4.2/src/ai_docs_toolkit.egg-info → ai_docs_toolkit-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-docs-toolkit
-Version: 0.4.2
+Version: 0.5.1
 Summary: AI-oriented documentation toolkit.
 License-Expression: MIT
 Requires-Python: >=3.14
@@ -33,7 +33,7 @@ The core idea is that documentation should not be a secondary artifact created a
 
 ## Current Status
 
-Version 0.4.2 includes:
+Version 0.5.1 includes:
 
 - schema and structure validation for Markdown documents with YAML front matter;
 - document graph output;
@@ -45,32 +45,77 @@ Version 0.4.2 includes:
 - context bundle output;
 - an executable `ai-docs` CLI;
 - optional local MCP runtime entrypoint.
+- opt-in workspace impact analysis through CLI and MCP, with explicit manifests,
+  repository-scoped IDs, public event interfaces and visible partial results.
 
 ## Installation
 
-Install version 0.4.2 with Python 3.14 or newer:
+Install version 0.5.1 with Python 3.14 or newer:
 
 ```bash
-python -m pip install ai-docs-toolkit==0.4.2
+python -m pip install ai-docs-toolkit==0.5.1
 ai-docs --version
 ```
 
 For ephemeral execution with `uvx`:
 
 ```bash
-uvx --python 3.14 --from ai-docs-toolkit==0.4.2 ai-docs --version
+uvx --python 3.14 --from ai-docs-toolkit==0.5.1 ai-docs --version
 ```
 
 For the optional local MCP runtime:
 
 ```bash
-python -m pip install "ai-docs-toolkit[mcp]==0.4.2"
+python -m pip install "ai-docs-toolkit[mcp]==0.5.1"
 ai-docs-mcp --project-root .
 ```
 
 For the latest stable release, use `python -m pip install --upgrade ai-docs-toolkit`
 without an exact version pin.
 
+## Release 0.5.1
+
+Changed-path routing treats only Markdown (`.md`, case insensitive) inside
+configured roots as document candidates. Other files use explicit module
+ownership even within those roots. Local changed context now uses the same
+ownership declarations, preserving every matching module and changed path.
+Broken or deleted Markdown retains diagnostics; it cannot fall back to an owner.
+Unmapped paths remain visible. CLI names, config and JSON shapes are unchanged.
+
+Upgrade the pinned package to `0.5.1`, review `ai-docs init --dry-run` and refresh
+known unchanged managed references using ordinary `ai-docs init`. Preserve local
+policies, IDs, links and historical review evidence; do not use blanket force.
+Run validation and repeat the actual changed-path review, including mixed roots.
+Detailed commands and rollback: “Migration 0.5.0 To 0.5.1” in packaged agent docs.
+
+## Release 0.5.0
+
+`ai-docs workspace impact --workspace ./ai-docs.workspace.yaml --input ./change.yaml --format json`
+analyzes explicitly connected independent repositories. Stable repository IDs
+namespace document IDs; a system repository owns public event contracts and
+producer/consumer roles, while local bindings select implementation modules.
+Modules may be nested within a repository. Cross-repository `related.*` links
+and inferred dependency discovery are not required.
+
+The MCP tool is registered only when the server starts with `--workspace`;
+ordinary local commands retain their scope. JSON v1 preserves candidates,
+provenance and diagnostics when a checkout, binding or interface version is
+missing. A partial result is not a clean review, and resolved routing does not
+prove sufficient context or implementation compatibility.
+
+Upgrading from 0.4.2 refreshes four managed workspace schemas and the consumer
+reference in both `minimal` and `agent` profiles. Review `init --dry-run` and
+`init --check` with the existing profile, reconcile local modifications, then
+run ordinary `init` without blanket `--force`. Project documents, IDs, local
+policy and configuration remain project-owned. Repository IDs, manifests and
+bindings require manual opt-in; init does not discover neighboring repositories.
+Exact commands and rollback are in “Migration 0.4.2 To 0.5.0” in the packaged
+`ai_docs_toolkit/docs/agent-installation.md`.
+
+Verification includes installed CLI/MCP and upgrade matrices plus a bounded
+HAM documentation evaluation. Its accepted result retains native-format
+validation findings; it is not a full HAM migration or service runtime check.
+
 ## Release 0.4.2
 
 The package now declares the MIT license in its metadata and includes the full

{ai_docs_toolkit-0.4.2 → ai_docs_toolkit-0.5.1}/README.md

@@ -2,7 +2,7 @@
 
 AI Docs Toolkit is a documentation toolkit for AI-assisted software development.
 
-It treats documentation as an engineering interface between humans, AI agents, code, tests and change management. The 0.4.2 source declares the MIT license and retains the 0.4.1 impact, review and code-link improvements. Python 3.14 or newer is required.
+It treats documentation as an engineering interface between humans, AI agents, code, tests and change management. Version 0.5.1 fixes changed-path routing in mixed documentation roots across local CLI and workspace CLI/MCP. The package uses the MIT license and requires Python 3.14 or newer.
 
 ## Purpose
 
@@ -34,6 +34,7 @@ The stable package provides:
 - impact analysis;
 - context selection with history filtering, optional body budgets and configurable depth;
 - proportionate agent workflows and optional MCP integration;
+- explicit workspace manifests, repository-scoped document IDs and public event interface routing;
 - CI, pre-commit and agent workflow examples.
 
 At this stage the repository contains:
@@ -83,10 +84,15 @@ pipx install ai-docs-toolkit
 uvx --from ai-docs-toolkit ai-docs validate
 ```
 
-[Version 0.4.1 is available on Public PyPI](https://pypi.org/project/ai-docs-toolkit/0.4.1/).
-Version 0.4.2 is prepared for publication with MIT license metadata and updated
-product guidance. It changes no CLI, schema, template or runtime behavior.
-See the [0.4.1 → 0.4.2 upgrade note](src/ai_docs_toolkit/docs/agent-installation.md#migration-041-to-042).
+[Release 0.5.1](ai-docs/reference/releases/0-5-1.md) fixes mixed-root routing and adds explicit module ownership to changed context. See the [0.5.0 → 0.5.1 upgrade guide](src/ai_docs_toolkit/docs/agent-installation.md#migration-050-to-051).
+
+[Release 0.5.0](ai-docs/reference/releases/0-5-0.md) adds `ai-docs workspace impact`
+and the explicitly enabled MCP workspace tool. Existing repository-local commands
+keep their scope. See the [0.4.2 → 0.5.0 migration guide](src/ai_docs_toolkit/docs/agent-installation.md#migration-042-to-050)
+for the managed schema/reference refresh in both init profiles and manual opt-in.
+Registry availability is shown on [Public PyPI](https://pypi.org/project/ai-docs-toolkit/).
+If upgrading from 0.4.1, also read the
+[0.4.1 → 0.4.2 upgrade note](src/ai_docs_toolkit/docs/agent-installation.md#migration-041-to-042).
 If upgrading from 0.4.0, also follow the
 [0.4.0 → 0.4.1 migration guide](src/ai_docs_toolkit/docs/agent-installation.md#migration-040-to-041).
 That patch required no schema, configuration or managed-template content migration;
@@ -270,7 +276,7 @@ The MVP does not aim to provide:
 - full IDE plugins;
 - hosted services;
 - database-backed graph storage;
-- cross-repository dependency graphs.
+- inferred or transitive cross-repository dependency graphs beyond explicit public interface bindings.
 
 ## License
 

{ai_docs_toolkit-0.4.2 → ai_docs_toolkit-0.5.1}/packaging/pypi/README.md

@@ -16,7 +16,7 @@ The core idea is that documentation should not be a secondary artifact created a
 
 ## Current Status
 
-Version 0.4.2 includes:
+Version 0.5.1 includes:
 
 - schema and structure validation for Markdown documents with YAML front matter;
 - document graph output;
@@ -28,32 +28,77 @@ Version 0.4.2 includes:
 - context bundle output;
 - an executable `ai-docs` CLI;
 - optional local MCP runtime entrypoint.
+- opt-in workspace impact analysis through CLI and MCP, with explicit manifests,
+  repository-scoped IDs, public event interfaces and visible partial results.
 
 ## Installation
 
-Install version 0.4.2 with Python 3.14 or newer:
+Install version 0.5.1 with Python 3.14 or newer:
 
 ```bash
-python -m pip install ai-docs-toolkit==0.4.2
+python -m pip install ai-docs-toolkit==0.5.1
 ai-docs --version
 ```
 
 For ephemeral execution with `uvx`:
 
 ```bash
-uvx --python 3.14 --from ai-docs-toolkit==0.4.2 ai-docs --version
+uvx --python 3.14 --from ai-docs-toolkit==0.5.1 ai-docs --version
 ```
 
 For the optional local MCP runtime:
 
 ```bash
-python -m pip install "ai-docs-toolkit[mcp]==0.4.2"
+python -m pip install "ai-docs-toolkit[mcp]==0.5.1"
 ai-docs-mcp --project-root .
 ```
 
 For the latest stable release, use `python -m pip install --upgrade ai-docs-toolkit`
 without an exact version pin.
 
+## Release 0.5.1
+
+Changed-path routing treats only Markdown (`.md`, case insensitive) inside
+configured roots as document candidates. Other files use explicit module
+ownership even within those roots. Local changed context now uses the same
+ownership declarations, preserving every matching module and changed path.
+Broken or deleted Markdown retains diagnostics; it cannot fall back to an owner.
+Unmapped paths remain visible. CLI names, config and JSON shapes are unchanged.
+
+Upgrade the pinned package to `0.5.1`, review `ai-docs init --dry-run` and refresh
+known unchanged managed references using ordinary `ai-docs init`. Preserve local
+policies, IDs, links and historical review evidence; do not use blanket force.
+Run validation and repeat the actual changed-path review, including mixed roots.
+Detailed commands and rollback: “Migration 0.5.0 To 0.5.1” in packaged agent docs.
+
+## Release 0.5.0
+
+`ai-docs workspace impact --workspace ./ai-docs.workspace.yaml --input ./change.yaml --format json`
+analyzes explicitly connected independent repositories. Stable repository IDs
+namespace document IDs; a system repository owns public event contracts and
+producer/consumer roles, while local bindings select implementation modules.
+Modules may be nested within a repository. Cross-repository `related.*` links
+and inferred dependency discovery are not required.
+
+The MCP tool is registered only when the server starts with `--workspace`;
+ordinary local commands retain their scope. JSON v1 preserves candidates,
+provenance and diagnostics when a checkout, binding or interface version is
+missing. A partial result is not a clean review, and resolved routing does not
+prove sufficient context or implementation compatibility.
+
+Upgrading from 0.4.2 refreshes four managed workspace schemas and the consumer
+reference in both `minimal` and `agent` profiles. Review `init --dry-run` and
+`init --check` with the existing profile, reconcile local modifications, then
+run ordinary `init` without blanket `--force`. Project documents, IDs, local
+policy and configuration remain project-owned. Repository IDs, manifests and
+bindings require manual opt-in; init does not discover neighboring repositories.
+Exact commands and rollback are in “Migration 0.4.2 To 0.5.0” in the packaged
+`ai_docs_toolkit/docs/agent-installation.md`.
+
+Verification includes installed CLI/MCP and upgrade matrices plus a bounded
+HAM documentation evaluation. Its accepted result retains native-format
+validation findings; it is not a full HAM migration or service runtime check.
+
 ## Release 0.4.2
 
 The package now declares the MIT license in its metadata and includes the full

{ai_docs_toolkit-0.4.2 → ai_docs_toolkit-0.5.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ai-docs-toolkit"
-version = "0.4.2"
+version = "0.5.1"
 description = "AI-oriented documentation toolkit."
 readme = "packaging/pypi/README.md"
 requires-python = ">=3.14"
@@ -41,6 +41,7 @@ ai_docs_toolkit = [
   "templates/project/.ai-docs/reference/*.md",
   "templates/project/.ai-docs/schemas/*.schema.yaml",
   "templates/project/.ai-docs/schemas/document-types/*.schema.yaml",
+  "templates/project/.ai-docs/schemas/workspace/*-v1.schema.yaml",
   "templates/project/.ai-docs/templates/release/*.md",
   "templates/project/.ai-docs/workflows/*.md",
 ]

{ai_docs_toolkit-0.4.2 → ai_docs_toolkit-0.5.1}/src/ai_docs_toolkit/__init__.py

@@ -1,3 +1,3 @@
 """AI Docs Toolkit package baseline."""
 
-__version__ = "0.4.2"
+__version__ = "0.5.1"

{ai_docs_toolkit-0.4.2 → ai_docs_toolkit-0.5.1}/src/ai_docs_toolkit/cli/__init__.py

@@ -91,6 +91,7 @@ def _help_text() -> str:
             "  ai-docs tasks push --provider azure-devops (--task TASK-ID | --stage STAGE-ID | --plan PLAN-ID) --organization ORG --project PROJECT [--dry-run] [--write-back] [--format json]",
             "  ai-docs graph --format json [--type TYPE] [--module MODULE] [--id ID]",
             "  ai-docs impact (--id ID | --changed [--base REF]) [--format json]",
+            "  ai-docs workspace impact --workspace FILE --input FILE [--format human|json]",
             "  ai-docs code-links-check FILE... [--format human|json|--json]",
             "  ai-docs review-check RECORD [--record N] [--format json|--json]",
             "  ai-docs context (--id ID | --module MODULE | --feature FEATURE | --changed) [--format json] [--history exclude|include|legacy] [--body-budget-bytes N] [--depth N]",
@@ -110,6 +111,11 @@ def main(argv: list[str] | None = None) -> int:
 
         args = sys.argv[1:]
 
+    if args and args[0] == "workspace":
+        from .workspace import main as workspace_main
+
+        return workspace_main(args[1:])
+
     if not args or "--help" in args or "-h" in args:
         print(_help_text())
         return 0

ai_docs_toolkit-0.5.1/src/ai_docs_toolkit/cli/workspace.py

@@ -0,0 +1,58 @@
+"""Explicit workspace CLI adapter; domain results come from the shared service."""
+
+import argparse
+import sys
+
+from ai_docs_toolkit.workspace import analyze_workspace_file, format_workspace_json
+
+
+class UsageError(ValueError):
+    pass
+
+
+class WorkspaceParser(argparse.ArgumentParser):
+    def error(self, message):
+        raise UsageError(message)
+
+
+def main(argv: list[str]) -> int:
+    parser = WorkspaceParser(prog="ai-docs workspace impact", allow_abbrev=False)
+    parser.add_argument("--workspace", required=True, help="Explicit workspace manifest path.")
+    parser.add_argument("--input", required=True, help="Saved JSON/YAML request v1 path.")
+    parser.add_argument("--format", choices=("human", "json"), default="human")
+    try:
+        if not argv or argv[0] != "impact":
+            raise UsageError("expected 'workspace impact'")
+        # Duplicate selectors are ambiguous even if argparse would accept the last value.
+        options = [arg.split("=", 1)[0] for arg in argv[1:] if arg.startswith("--")]
+        if len(options) != len(set(options)):
+            raise UsageError("duplicate option")
+        args = parser.parse_args(argv[1:])
+    except UsageError as exc:
+        parser.print_usage(sys.stderr)
+        print(f"{parser.prog}: error: {exc}", file=sys.stderr)
+        return 3
+    except SystemExit as exc:
+        return int(exc.code)
+    result = analyze_workspace_file(args.workspace, args.input)
+    print(format_workspace_json(result) if args.format == "json" else format_human(result), end="")
+    return result["exit_code"]
+
+
+def format_human(result: dict) -> str:
+    lines = [f"Workspace routing: {result['routing_status']} (exit {result['exit_code']})",
+             f"Sources: {len(result['sources'])}; candidates: {len(result['candidates'])}"]
+    for kind in ("sources", "candidates"):
+        for document in result[kind]:
+            lines.append(f"{kind}: {document['repository_id']}:{document['document_id']}")
+    for gap in result["gaps"]:
+        lines.append(f"Gap {gap['code']} [{gap['repository_id']}]: {gap['message']}")
+    for review in result["reviews"]:
+        if review["system_review_required"]:
+            lines.append(f"System review required: {review['repository_id']} ({review['interface_impact']})")
+    for context in result["context"]:
+        for field in ("warnings", "gaps", "excluded", "historical"):
+            if context.get(field):
+                lines.append(f"Context {context['repository_id']} {field}: {len(context[field])}")
+    lines.append("Routing completion does not mean review completion or sufficient context. Use --format json for evidence.")
+    return "\n".join(lines) + "\n"

{ai_docs_toolkit-0.4.2 → ai_docs_toolkit-0.5.1}/src/ai_docs_toolkit/context/markdown_output.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import hashlib
 import json
-from dataclasses import asdict, dataclass
+from dataclasses import asdict, dataclass, replace
 from pathlib import Path
 
 from ai_docs_toolkit.core import (
@@ -23,8 +23,11 @@ from ai_docs_toolkit.core import (
 )
 from ai_docs_toolkit.core.changed_files import (
     ChangedFileIssue,
+    cascade_module_issues,
+    is_documentation_candidate,
     read_git_changed_files,
     resolve_changed_document_sources,
+    resolve_changed_module_sources,
 )
 from ai_docs_toolkit.core.config import context_settings_error
 from ai_docs_toolkit.core.context import ContextPolicy
@@ -108,26 +111,57 @@ def context_project(
     elif mode == "changed":
         changed = _git_changed_files(context_result.root)
         source_result = resolve_changed_document_sources(
-            changed.changed_files,
+            tuple(
+                path for path in changed.changed_files
+                if is_documentation_candidate((context_result.root / path).resolve(), config)
+            ),
             config=config,
             registry=registry,
             root=context_result.root,
             outside_docs_rule_id=RULE_CHANGED_FILE_OUTSIDE_DOCS,
             not_document_rule_id=RULE_CHANGED_FILE_NOT_DOCUMENT,
         )
+        modules = resolve_changed_module_sources(
+            changed.changed_files,
+            config=config,
+            outside_docs_rule_id=RULE_CHANGED_FILE_OUTSIDE_DOCS,
+        )
+        valid_modules = tuple(
+            source for source in modules.sources
+            if (document := registry.get_by_id(source.document_id)) is not None
+            and document.frontmatter.get("type") == "module"
+        )
+        changed_by_id = dict(source_result.changed_files_by_id)
+        for source in valid_modules:
+            changed_by_id.setdefault(source.document_id, source.changed_file)
         errors.extend(_changed_file_errors(changed.issues))
+        errors.extend(_changed_file_errors(
+            cascade_module_issues(config, registry, rule_prefix="document.context")
+        ))
         warnings.extend(
-            _changed_file_warnings((*changed.issues, *source_result.issues))
+            _changed_file_warnings((*changed.issues, *source_result.issues, *modules.issues))
         )
         selection = select_context_by_changed_ids(
             graph,
             registry,
-            {
-                id: source_result.changed_files_by_id[id]
-                for id in source_result.source_ids
-            },
+            changed_by_id,
             policy=policy,
         )
+        # Retain every origin without traversing the same module body repeatedly.
+        origins = []
+        for source in selection.sources:
+            if source.document_id in source_result.changed_files_by_id:
+                origins.append(replace(
+                    source, changed_file=source_result.changed_files_by_id[source.document_id]
+                ))
+            origins.extend(
+                replace(source, source="module_ownership", changed_file=match.changed_file)
+                for match in valid_modules if match.document_id == source.document_id
+            )
+        selection = replace(selection, sources=tuple(sorted(
+            origins,
+            key=lambda source: (source.source, source.document_id, source.path, source.changed_file or ""),
+        )))
     else:
         raise ValueError(f"Unsupported context mode: {mode}")
     errors.extend(_selection_errors(selection))

{ai_docs_toolkit-0.4.2 → ai_docs_toolkit-0.5.1}/src/ai_docs_toolkit/core/changed_files.py

@@ -49,9 +49,15 @@ def read_git_changed_files(
     *,
     unavailable_rule_id: str,
     base_ref: str | None = None,
+    git_config: tuple[str, ...] = (),
 ) -> GitChangedFilesResult:
+    """Discover local paths; optional process config lets isolated callers disable hooks.
+
+    Workspace analysis passes `-c core.fsmonitor=false` so reading a checkout
+    cannot execute its monitor program. Existing callers retain their defaults.
+    """
     process = subprocess.run(
-        ["git", "status", "--porcelain", "-z", "--untracked-files=all"],
+        ["git", *git_config, "status", "--porcelain", "-z", "--untracked-files=all"],
         cwd=root,
         capture_output=True,
         text=True,
@@ -76,6 +82,7 @@ def read_git_changed_files(
         diff_process = subprocess.run(
             [
                 "git",
+                *git_config,
                 "diff",
                 "--name-only",
                 "-z",
@@ -200,6 +207,50 @@ def is_inside_documentation_roots(path: Path, config: ToolkitConfig) -> bool:
     return False
 
 
+def is_documentation_candidate(path: Path, config: ToolkitConfig) -> bool:
+    """Classify Markdown by path, even when it is missing or cannot be parsed.
+
+    Other assets may share documentation roots and retain explicit ownership.
+    Parsing success must never turn broken/deleted Markdown into a code source.
+    """
+    return path.suffix.lower() == ".md" and is_inside_documentation_roots(path, config)
+
+
+def cascade_module_issues(
+    config: ToolkitConfig,
+    registry: DocumentRegistry,
+    *,
+    rule_prefix: str,
+) -> tuple[ChangedFileIssue, ...]:
+    """Validate explicit root/owner identities before accepting module sources."""
+    configured = (
+        [(config.cascade.root_module, "root")] if config.cascade.root_module else []
+    )
+    configured.extend((owner.module_id, "owner") for owner in config.cascade.module_ownership)
+    issues = []
+    for document_id, role in configured:
+        document = registry.get_by_id(document_id)
+        if document is None:
+            issues.append(
+                ChangedFileIssue(
+                    rule_id=f"{rule_prefix}.cascade_{role}_unknown",
+                    message=f"Cascade configuration references unknown module document id `{document_id}`.",
+                    document_id=document_id,
+                    severity="error",
+                )
+            )
+        elif document.frontmatter.get("type") != "module":
+            issues.append(
+                ChangedFileIssue(
+                    rule_id=f"{rule_prefix}.cascade_{role}_not_module",
+                    message=f"Cascade configuration document `{document_id}` must have type `module`.",
+                    document_id=document_id,
+                    severity="error",
+                )
+            )
+    return tuple(issues)
+
+
 def resolve_changed_module_sources(
     changed_files: tuple[str, ...],
     *,
@@ -211,7 +262,7 @@ def resolve_changed_module_sources(
 
     for changed_file in changed_files:
         changed_path = (config.project_root / changed_file).resolve()
-        if is_inside_documentation_roots(changed_path, config):
+        if is_documentation_candidate(changed_path, config):
             continue
 
         matched = False
@@ -226,17 +277,12 @@ def resolve_changed_module_sources(
                 )
 
         if not matched:
-            ownership_suffix = (
-                " and module ownership paths"
-                if config.cascade.module_ownership
-                else ""
-            )
             issues.append(
                 ChangedFileIssue(
                     rule_id=outside_docs_rule_id,
                     message=(
-                        f"Changed file `{changed_file}` is outside configured "
-                        f"documentation roots{ownership_suffix}."
+                        f"Changed file `{changed_file}` is not a documentation candidate "
+                        "and matches no configured module ownership paths."
                     ),
                     path=changed_file,
                     severity="warning",

{ai_docs_toolkit-0.4.2 → ai_docs_toolkit-0.5.1}/src/ai_docs_toolkit/core/init.py

@@ -440,6 +440,36 @@ BOOTSTRAP_TEMPLATES = (
         profiles=frozenset({"agent"}),
         overwrite_existing=True,
     ),
+    BootstrapTemplate(
+        source_name=".ai-docs/schemas/workspace/manifest-v1.schema.yaml",
+        target_path=".ai-docs/schemas/workspace/manifest-v1.schema.yaml",
+        profiles=frozenset({"minimal", "agent"}),
+        overwrite_existing=True,
+    ),
+    BootstrapTemplate(
+        source_name=".ai-docs/schemas/workspace/request-v1.schema.yaml",
+        target_path=".ai-docs/schemas/workspace/request-v1.schema.yaml",
+        profiles=frozenset({"minimal", "agent"}),
+        overwrite_existing=True,
+    ),
+    BootstrapTemplate(
+        source_name=".ai-docs/schemas/workspace/repository-v1.schema.yaml",
+        target_path=".ai-docs/schemas/workspace/repository-v1.schema.yaml",
+        profiles=frozenset({"minimal", "agent"}),
+        overwrite_existing=True,
+    ),
+    BootstrapTemplate(
+        source_name=".ai-docs/schemas/workspace/result-v1.schema.yaml",
+        target_path=".ai-docs/schemas/workspace/result-v1.schema.yaml",
+        profiles=frozenset({"minimal", "agent"}),
+        overwrite_existing=True,
+    ),
+    BootstrapTemplate(
+        source_name=".ai-docs/reference/workspace-analysis.md",
+        target_path=".ai-docs/reference/workspace-analysis.md",
+        profiles=frozenset({"minimal", "agent"}),
+        overwrite_existing=True,
+    ),
 )