Integration: collapsed PRs #319, #318, #316, #314, #315, #317, #320 into integration

[Trecek]

Integration Summary

Collapsed 7 PRs into pr-batch/pr-merge-20260310-163009 targeting integration.

Merged PRs

#	Title	Complexity	Additions	Deletions	Overlaps
#319	Add Step 4.5 Historical Regression Check to dry-walkthrough skill	simple	+200	-0	—
#318	Implementation Plan: Pipeline Observability — Quota Guard Logging and Per-Step Elapsed Time	simple	+267	-23	—
#316	Release CI Automation — Version Bump, Branch Sync, and Release Infrastructure	simple	+471	-0	—
#314	docs: complete release documentation sprint	simple	+1344	-104	—
#315	Recipe remediation — source_dir resolution and cook command display	simple	+317	-71	#320
#317	Implementation Plan: PR Review Pipeline Gates — Fidelity Checks, CI Gating, and Review-First Enforcement	simple	+1057	-7	#320
#320	feat: add recipe composition with run_recipe tool and dev-sprint consumer	needs_check	+724	-19	#315, #317

Audit

Verdict: GO

Architecture Impact

Development Diagram

%%{init: {'flowchart': {'nodeSpacing': 50, 'rankSpacing': 60, 'curve': 'basis'}}}%%
flowchart TB
    %% CLASS DEFINITIONS %%
    classDef cli fill:#1a237e,stroke:#7986cb,stroke-width:2px,color:#fff;
    classDef stateNode fill:#004d40,stroke:#4db6ac,stroke-width:2px,color:#fff;
    classDef handler fill:#e65100,stroke:#ffb74d,stroke-width:2px,color:#fff;
    classDef phase fill:#6a1b9a,stroke:#ba68c8,stroke-width:2px,color:#fff;
    classDef newComponent fill:#2e7d32,stroke:#81c784,stroke-width:2px,color:#fff;
    classDef output fill:#00695c,stroke:#4db6ac,stroke-width:2px,color:#fff;
    classDef detector fill:#b71c1c,stroke:#ef5350,stroke-width:2px,color:#fff;
    classDef terminal fill:#1a237e,stroke:#7986cb,stroke-width:2px,color:#fff;

    subgraph Structure ["PROJECT STRUCTURE"]
        direction LR
        SRC["src/autoskillit/<br/>━━━━━━━━━━<br/>105 source files<br/>10 sub-packages"]
        TESTS["tests/<br/>━━━━━━━━━━<br/>170 test files<br/>Mirrors src layout"]
    end

    subgraph Build ["BUILD TOOLING"]
        direction LR
        PYPROJECT["● pyproject.toml<br/>━━━━━━━━━━<br/>hatchling backend<br/>uv package manager"]
        TASKFILE["Taskfile.yml<br/>━━━━━━━━━━<br/>task test-all<br/>task test-check<br/>task install-worktree"]
        UVLOCK["uv.lock<br/>━━━━━━━━━━<br/>Locked manifest"]
    end

    subgraph PreCommit ["PRE-COMMIT HOOKS"]
        direction TB
        RUFF_FMT["ruff-format<br/>━━━━━━━━━━<br/>Auto-format<br/>(writes source)"]
        RUFF_LINT["ruff check<br/>━━━━━━━━━━<br/>Lint --fix<br/>target: py311"]
        MYPY["mypy<br/>━━━━━━━━━━<br/>src/ type check<br/>--ignore-missing"]
        UVCHECK["uv lock --check<br/>━━━━━━━━━━<br/>Lockfile guard"]
        NOGEN["no-generated-configs<br/>━━━━━━━━━━<br/>Blocks hooks.json<br/>recipes/diagrams/"]
        GITLEAKS["gitleaks v8.30.0<br/>━━━━━━━━━━<br/>Secret scanning"]
    end

    subgraph Testing ["TEST FRAMEWORK"]
        direction LR
        PYTEST["pytest -n 4<br/>━━━━━━━━━━<br/>asyncio_mode=auto<br/>timeout=60s"]
        FIXTURES["conftest.py<br/>━━━━━━━━━━<br/>StatefulMockTester<br/>MockSubprocessRunner<br/>tool_ctx fixture"]
        IMPORTLINT["import-linter<br/>━━━━━━━━━━<br/>L0→L1→L2→L3<br/>Architecture gates"]
    end

    subgraph NewTests ["★ NEW TEST FILES"]
        direction LR
        TGATE["★ test_analyze_prs_gates.py<br/>━━━━━━━━━━<br/>PR gate analysis"]
        TFIDELITY["★ test_review_pr_fidelity.py<br/>━━━━━━━━━━<br/>Fidelity checks"]
        TRELEASE["★ test_release_workflows.py<br/>━━━━━━━━━━<br/>CI workflow tests"]
        TDRY["★ test_dry_walkthrough_contracts.py<br/>━━━━━━━━━━<br/>10 contract assertions"]
    end

    subgraph CI ["CI/CD WORKFLOWS"]
        direction TB
        TESTS_CI["tests.yml<br/>━━━━━━━━━━<br/>ubuntu + macos matrix<br/>preflight: uv lock --check<br/>uv sync + task test-all"]
        VBUMP["★ version-bump.yml<br/>━━━━━━━━━━<br/>integration→main merged<br/>MAJOR.MINOR.PATCH+1<br/>sync main→integration"]
        RELEASE["★ release.yml<br/>━━━━━━━━━━<br/>stable branch merge<br/>MAJOR.MINOR+1.0<br/>git tag + GitHub Release"]
    end

    subgraph EntryPoints ["ENTRY POINTS"]
        direction LR
        CLI_EP["autoskillit CLI<br/>━━━━━━━━━━<br/>autoskillit.cli:main<br/>● app.py modified"]
        INSTALL["★ install.sh<br/>━━━━━━━━━━<br/>End-user installer<br/>uv tool install<br/>autoskillit install"]
    end

    %% FLOW %%
    SRC --> PYPROJECT
    TESTS --> PYPROJECT
    PYPROJECT --> TASKFILE
    PYPROJECT --> UVLOCK

    TASKFILE --> RUFF_FMT
    RUFF_FMT --> RUFF_LINT
    RUFF_LINT --> MYPY
    MYPY --> UVCHECK
    UVCHECK --> NOGEN
    NOGEN --> GITLEAKS

    TASKFILE --> PYTEST
    PYTEST --> FIXTURES
    PYTEST --> IMPORTLINT
    PYTEST --> TGATE
    PYTEST --> TFIDELITY
    PYTEST --> TRELEASE
    PYTEST --> TDRY

    PYPROJECT --> TESTS_CI
    TESTS_CI --> VBUMP
    VBUMP --> RELEASE

    PYPROJECT --> CLI_EP
    INSTALL --> CLI_EP

    %% CLASS ASSIGNMENTS %%
    class SRC,TESTS cli;
    class PYPROJECT,TASKFILE,UVLOCK phase;
    class RUFF_FMT,RUFF_LINT,MYPY,UVCHECK,NOGEN,GITLEAKS detector;
    class PYTEST,FIXTURES,IMPORTLINT handler;
    class TGATE,TFIDELITY,TRELEASE,TDRY,VBUMP,RELEASE,INSTALL newComponent;
    class TESTS_CI stateNode;
    class CLI_EP output;

Loading

Process Flow Diagram

%%{init: {'flowchart': {'nodeSpacing': 40, 'rankSpacing': 50, 'curve': 'basis'}}}%%
flowchart TB
    %% CLASS DEFINITIONS %%
    classDef terminal fill:#1a237e,stroke:#7986cb,stroke-width:2px,color:#fff;
    classDef stateNode fill:#004d40,stroke:#4db6ac,stroke-width:2px,color:#fff;
    classDef handler fill:#e65100,stroke:#ffb74d,stroke-width:2px,color:#fff;
    classDef phase fill:#6a1b9a,stroke:#ba68c8,stroke-width:2px,color:#fff;
    classDef newComponent fill:#2e7d32,stroke:#81c784,stroke-width:2px,color:#fff;
    classDef detector fill:#b71c1c,stroke:#ef5350,stroke-width:2px,color:#fff;
    classDef integration fill:#c62828,stroke:#ef9a9a,stroke-width:2px,color:#fff;

    %% TERMINALS %%
    START([START])
    SUCCESS([SUCCESS])
    VALFAIL([VALIDATION ERROR])

    subgraph Val ["Load-Time Validation"]
        direction LR
        ValidateRecipe["validate_recipe<br/>━━━━━━━━━━<br/>recipe/_api.py"]
        RulesRecipe["★ rules_recipe.py<br/>━━━━━━━━━━<br/>unknown-sub-recipe rule"]
        AvailCtx["★ available_recipes<br/>━━━━━━━━━━<br/>ValidationContext field"]
        NameKnown{"sub-recipe<br/>name known?"}
    end

    subgraph Exec ["Runtime Execution"]
        direction TB
        ToolHandler["★ run_recipe<br/>━━━━━━━━━━<br/>server/tools_recipe.py"]
        FindRecipe["★ _find_recipe()<br/>━━━━━━━━━━<br/>server/helpers.py"]
        FoundDec{"recipe<br/>file found?"}
        RunSub["★ _run_subrecipe_session()<br/>━━━━━━━━━━<br/>server/helpers.py"]
        BuildPrompt["★ build_subrecipe_prompt()<br/>━━━━━━━━━━<br/>cli/_prompts.py"]
        BuildCmd["★ build_subrecipe_cmd()<br/>━━━━━━━━━━<br/>execution/commands.py"]
        SubSess["★ run_subrecipe_session()<br/>━━━━━━━━━━<br/>execution/headless.py"]
    end

    HeadlessProc["Headless Claude<br/>━━━━━━━━━━<br/>AUTOSKILLIT_KITCHEN_OPEN=1<br/>executes sub-recipe YAML"]
    ResultDec{"success: True?"}

    START -->|"recipe YAML loaded"| ValidateRecipe
    ValidateRecipe --> RulesRecipe
    RulesRecipe --> AvailCtx
    AvailCtx --> NameKnown
    NameKnown -->|"unknown name"| VALFAIL
    NameKnown -->|"valid"| ToolHandler
    ToolHandler --> FindRecipe
    FindRecipe --> FoundDec
    FoundDec -->|"not found"| SUCCESS
    FoundDec -->|"found"| RunSub
    RunSub --> BuildPrompt
    RunSub --> BuildCmd
    BuildPrompt -->|"prompt str"| SubSess
    BuildCmd -->|"CLI cmd + env"| SubSess
    SubSess --> HeadlessProc
    HeadlessProc --> ResultDec
    ResultDec -->|"yes"| SUCCESS
    ResultDec -->|"no"| SUCCESS

    %% CLASS ASSIGNMENTS %%
    class START,SUCCESS,VALFAIL terminal;
    class ValidateRecipe handler;
    class RulesRecipe detector;
    class AvailCtx,NameKnown,FoundDec stateNode;
    class ToolHandler,FindRecipe,RunSub,BuildPrompt,BuildCmd,SubSess newComponent;
    class HeadlessProc integration;
    class ResultDec stateNode;

Loading

Deployment Diagram

%%{init: {'flowchart': {'nodeSpacing': 50, 'rankSpacing': 60, 'curve': 'basis'}}}%%
flowchart TB
    %% CLASS DEFINITIONS %%
    classDef cli fill:#1a237e,stroke:#7986cb,stroke-width:2px,color:#fff;
    classDef stateNode fill:#004d40,stroke:#4db6ac,stroke-width:2px,color:#fff;
    classDef handler fill:#e65100,stroke:#ffb74d,stroke-width:2px,color:#fff;
    classDef phase fill:#6a1b9a,stroke:#ba68c8,stroke-width:2px,color:#fff;
    classDef newComponent fill:#2e7d32,stroke:#81c784,stroke-width:2px,color:#fff;
    classDef output fill:#00695c,stroke:#4db6ac,stroke-width:2px,color:#fff;
    classDef integration fill:#c62828,stroke:#ef9a9a,stroke-width:2px,color:#fff;
    classDef detector fill:#b71c1c,stroke:#ef5350,stroke-width:2px,color:#fff;

    subgraph DevMachine ["DEVELOPER MACHINE"]
        direction TB

        subgraph Bootstrap ["BOOTSTRAP (★ NEW)"]
            INSTALL_SH["★ install.sh<br/>━━━━━━━━━━<br/>curl from GitHub stable<br/>Python 3.11+ · uv · claude<br/>uv tool install"]
        end

        subgraph UVTool ["INSTALLED PACKAGE"]
            PKG["autoskillit package<br/>━━━━━━━━━━<br/>~/.local/share/uv/tools/<br/>autoskillit/lib/python3.x/<br/>site-packages/autoskillit/"]
            PLUGIN_CACHE["Plugin cache<br/>━━━━━━━━━━<br/>~/.claude/plugins/cache/<br/>autoskillit-local/"]
        end

        subgraph ClaudeCode ["CLAUDE CODE PROCESS"]
            CC["Claude Code IDE<br/>━━━━━━━━━━<br/>Reads hooks from<br/>~/.claude/settings.json<br/>.claude/settings.json"]
            MCP["● MCP Server (stdio)<br/>━━━━━━━━━━<br/>FastMCP · stdin/stdout<br/>12 ungated + 26 kitchen tools<br/>★ run_recipe · ★ get_ci_status"]
        end

        subgraph HeadlessSessions ["HEADLESS SUBPROCESS SESSIONS (pty)"]
            SKILL_SESS["Skill session<br/>━━━━━━━━━━<br/>claude --print prompt<br/>AUTOSKILLIT_HEADLESS=1<br/>KITCHEN_OPEN via open_kitchen"]
            SUBRECIPE["★ Sub-recipe session<br/>━━━━━━━━━━<br/>claude --print sous-chef-prompt<br/>AUTOSKILLIT_KITCHEN_OPEN=1<br/>NO HEADLESS flag<br/>build_subrecipe_cmd"]
        end

        subgraph LocalStorage ["LOCAL STORAGE"]
            SESSION_LOGS[("Session logs<br/>━━━━━━━━━━<br/>~/.local/share/autoskillit/<br/>logs/sessions/*.jsonl<br/>proc_trace · anomalies")]
            CRASH_TMP[("Crash traces<br/>━━━━━━━━━━<br/>/dev/shm/<br/>autoskillit_trace_pid.jsonl<br/>Linux tmpfs")]
            PROJ_STORE[("Project storage<br/>━━━━━━━━━━<br/>project/.autoskillit/<br/>config.yaml · .secrets.yaml<br/>temp/ · recipes/")]
            CLAUDE_LOGS[("Claude Code logs<br/>━━━━━━━━━━<br/>~/.claude/projects/<br/>encoded-cwd/<br/>session-id.jsonl")]
        end
    end

    subgraph GitHub ["GITHUB INFRASTRUCTURE"]
        direction TB
        GH_ACTIONS["GitHub Actions<br/>━━━━━━━━━━<br/>tests.yml: ubuntu + macos-15<br/>uv sync · task test-all"]
        VBUMP_WF["★ version-bump.yml<br/>━━━━━━━━━━<br/>integration→main merge<br/>patch bump + uv lock<br/>sync main→integration"]
        RELEASE_WF["★ release.yml<br/>━━━━━━━━━━<br/>stable branch merge<br/>minor bump + uv lock<br/>git tag + GitHub Release"]
        GH_REPO["GitHub Repository<br/>━━━━━━━━━━<br/>main · integration · stable<br/>Issues · PRs · Releases"]
        GH_API["GitHub API<br/>━━━━━━━━━━<br/>api.github.com<br/>Actions runs · CI jobs<br/>Issues · PR reviews"]
    end

    subgraph Anthropic ["EXTERNAL: ANTHROPIC"]
        ANT_API["Anthropic API<br/>━━━━━━━━━━<br/>api.anthropic.com<br/>/api/oauth/usage<br/>5-hour quota check"]
    end

    %% BOOTSTRAP FLOW %%
    INSTALL_SH -->|"uv tool install git@stable"| PKG
    PKG -->|"autoskillit install<br/>claude plugin install"| PLUGIN_CACHE

    %% CLAUDE CODE %%
    PLUGIN_CACHE -->|"plugin load"| CC
    CC -->|"spawns stdio"| MCP

    %% MCP → SESSIONS %%
    MCP -->|"run_skill: spawns pty"| SKILL_SESS
    MCP -->|"★ run_recipe: spawns pty<br/>KITCHEN_OPEN=1"| SUBRECIPE

    %% STORAGE WRITES %%
    SKILL_SESS -->|"writes diagnostics"| SESSION_LOGS
    SKILL_SESS -->|"crash: writes"| CRASH_TMP
    SUBRECIPE -->|"writes diagnostics"| SESSION_LOGS
    MCP -->|"reads/writes"| PROJ_STORE
    CC -->|"writes JSONL"| CLAUDE_LOGS

    %% CI/RELEASE %%
    GH_REPO -->|"push/PR event"| GH_ACTIONS
    GH_REPO -->|"integration→main merge"| VBUMP_WF
    GH_REPO -->|"★ PR→stable merge"| RELEASE_WF
    RELEASE_WF -->|"creates"| GH_REPO
    VBUMP_WF -->|"pushes commits"| GH_REPO

    %% EXTERNAL API CALLS %%
    MCP -->|"httpx HTTPS<br/>CI polling"| GH_API
    GH_ACTIONS -->|"gh CLI"| GH_API
    MCP -->|"httpx HTTPS<br/>quota check"| ANT_API
    SKILL_SESS -->|"Anthropic API<br/>inference"| ANT_API

    %% CLASS ASSIGNMENTS %%
    class INSTALL_SH,VBUMP_WF,RELEASE_WF,SUBRECIPE newComponent;
    class CC,SKILL_SESS cli;
    class MCP,GH_ACTIONS handler;
    class PKG,PLUGIN_CACHE phase;
    class SESSION_LOGS,CRASH_TMP,PROJ_STORE,CLAUDE_LOGS stateNode;
    class GH_REPO,GH_API,ANT_API integration;

Loading

Closes #307
Closes #302
Closes #298
Closes #297
Closes #300
Closes #303

🤖 Generated with Claude Code via AutoSkillit