agentic-project-kit 1.0.4__tar.gz → 1.0.6__tar.gz

agentic_project_kit-1.0.6/.agentic/dpa/acceptance/current_handoff_operational_state.json

@@ -0,0 +1,33 @@
+{
+  "accepted_at": "2026-08-26T18:22:40.525787+00:00",
+  "accepted_gate_result": "pass",
+  "accepted_gate_set_id": "dpa-current-handoff-minimal-gate-set-v1",
+  "accepted_lifecycle_outcome": "accepted",
+  "branch": "docs/post-pr2187-handoff-refresh",
+  "claims": {
+    "generated_outputs_manually_patched": false,
+    "kit_conformance_claimed": false,
+    "production_mutation_performed": false
+  },
+  "contract_id": "DPA-CURRENT-HANDOFF-OPERATIONAL-STATE-v1",
+  "kind": "dpa_acceptance_state",
+  "renderer": {
+    "id": "agentic_project_kit.operational_handoff_projection",
+    "semantic_version": "1"
+  },
+  "schema_version": 1,
+  "source": {
+    "fingerprint": "ec22fad89788b6fbd5b9b1608b78a6ce568c80ab975d35470d33611f1cf9f882",
+    "path": ".agentic/operational_handoff_state.yaml"
+  },
+  "status": "accepted",
+  "target": {
+    "complete_target_fingerprint": "a75ad5a82612345ebc34920595db03f434714b2cd125ce1f1b853fab56653630",
+    "path": "docs/handoff/CURRENT_HANDOFF.md",
+    "payload_fingerprint": "a75ad5a82612345ebc34920595db03f434714b2cd125ce1f1b853fab56653630",
+    "pre_write_fingerprint": "81c2c24fbec8f0cad2f8d817f8e2c0999d14e772b9f3452d5590ca339b388a51"
+  },
+  "target_scope": "CURRENT_HANDOFF_OPERATIONAL_STATE_BLOCK",
+  "validation_ref": "4e30f785d7d90ec543def331b5e74ae09b99c294",
+  "writer_id": "WRT-CH-001"
+}

agentic_project_kit-1.0.6/.agentic/handoff_state.yaml

@@ -0,0 +1,449 @@
+schema_version: 1
+updated:
+  date: '2026-08-03'
+  reason: Refresh handoff state to last substantive work commit
+  source: agentic-kit handoff refresh
+repo:
+  name: agentic-project-kit
+  local_path: agentic-project-kit
+  remote: github.com:vfi64/agentic-project-kit
+  default_branch: main
+safe_state:
+  branch: main
+  commit: 4e30f785
+  commit_subject: Prepare release v1.0.6 (#2187)
+  semantics: last_substantive_work_state
+  working_tree_expected_clean: true
+  administrative_refresh_prs:
+  - 656
+  - 657
+  - 659
+  - 660
+  - 661
+  - 663
+  - 665
+  - 666
+  - 671
+  - 672
+  - 680
+  - 681
+  - 688
+  - 689
+  - 690
+  - 691
+  - 694
+  - 702
+  - 705
+  - 707
+  - 708
+  - 710
+  - 715
+  - 716
+  - 718
+  - 719
+  - 720
+  - 721
+  - 722
+  - 723
+  - 724
+  - 725
+  - 726
+  - 727
+  - 728
+  - 729
+  - 730
+  - 731
+  - 732
+  - 733
+  - 734
+  - 735
+  - 736
+  - 737
+  - 738
+  - 739
+  - 740
+  - 741
+  - 742
+  - 761
+  - 762
+  - 763
+  - 764
+  - 766
+  - 831
+  - 833
+  - 835
+  - 836
+  - 837
+  - 838
+  - 878
+  - 879
+  - 880
+  - 881
+  - 883
+  - 886
+  - 888
+  - 892
+  - 894
+  - 897
+  - 968
+release:
+  current_version: 0.4.13
+  previous_version: 0.4.12
+  tag: v0.4.13
+  github_release_exists: true
+  zenodo_concept_doi: 10.5281/zenodo.20101359
+  zenodo_version_doi: 10.5281/zenodo.21631484
+  post_release_check: PASS
+  post_release_evidence: CHANGELOG.md#v0413
+open_items:
+  prs: []
+  next_expected_chat_action: Continue after PR892 with post-merge gate visibility
+    follow-up work only after the post-merge refresh status gate reports NOOP.
+completed_since_previous_handoff:
+- 'PR #968 refreshed handoff state after README release-history extraction and v0.4.5
+  DOI closeout.'
+- 'PR #897 merged standard summary validator hardening before this administrative
+  handoff refresh.'
+- 'PR #894 merged post-merge gate bootstrap visibility documentation before this administrative
+  handoff refresh.'
+- 'PR #892 recorded the post-merge handoff refresh status gate visibility inventory
+  so the workflow can move the gate into more visible kit/ns paths.'
+- 'PR #888 added optional patch-preflight slice-gate enforcement so planning-document
+  preflight can require deterministic slice readiness and a clean worktree.'
+- 'PR #886 fixed workflow evidence hygiene by moving active next-turn/work-order results
+  out of the repo-backed fixed slot until explicit upload/promotion.'
+- 'PR #883 added the GUI gatekeeper implementation inventory and recorded that helper-local
+  PASS is not slice PASS without matching repository governance gates.'
+- 'PR #881 refreshed bootstrap/handoff state after PR #880; this post-PR881 refresh
+  records the resulting custom-subject administrative merge commit as current main.'
+- 'PR #880 accepted bounded administrative merge chains in the handoff freshness guard
+  while preserving blocking behavior for product merges inside such chains.'
+- 'PR #877 fixed the handoff freshness self-reference loop by checking freshly rendered
+  prompt text before warning.'
+- 'PR #876 recorded v0.4.4 DOI metadata and post-release evidence at docs/reports/terminal/v044-post-release-verify.log.'
+- 'PR #875 prepared v0.4.4 release metadata, after which v0.4.4 was tagged and post-release
+  verified with Zenodo version DOI 10.5281/zenodo.20431326.'
+- 'PR #874 records the GUI deterministic gatekeeper migration plan in docs/planning/GUI_DETERMINISTIC_GATEKEEPER_PLAN.md
+  as planning-only work.'
+- 'PR #873 added the GUI work order upload strip and was verified by docs/reports/terminal/pr873-final-main-closeout.log.'
+- 'PR #838 refreshed post-PR837 administrative handoff state and preserved the last
+  substantive safe-state distinction.'
+- 'PR #837 recorded the post-PR836 successor handoff prompt and evidence anchor.'
+- 'PR #838 refreshed post-PR837 administrative handoff state and preserved the last
+  substantive safe-state distinction.'
+- 'PR #837 recorded the post-PR836 successor handoff prompt and evidence anchor.'
+- 'PR #836 refreshed post-PR835 next-step state and is the current successor-handoff
+  safe-state anchor.'
+- 'PR #835 recorded PR #834 closeout evidence at docs/reports/terminal/pr834-merge-finalize.log
+  and added docs/reports/terminal/post-pr834-successor-handoff.md as the successor
+  anchor.'
+- 'PR #834 repaired generator-backed handoff freshness state so the generated successor
+  prompt anchors to the post-PR834 safe state.'
+- 'PR #833 recorded the corrected post-PR831 successor handoff at docs/reports/terminal/post-pr831-successor-handoff.md
+  and superseded the rejected PR825-era stale generated prompt.'
+- 'PR #831 recorded PR #830 closeout evidence at docs/reports/terminal/pr830-merge-finalize.log
+  and verified main 011b6dc24829be44c7693c468a90694981cd40ce for the successor handoff
+  anchor.'
+- 'PR #825 hardened active handoff freshness checks: state-freshness-check now fails
+  active next-step instructions that point to already-recorded closeout evidence or
+  stale release versions.'
+- 'PR #824 recorded PR #823 closeout evidence at docs/reports/terminal/pr823-merge-finalize.log
+  and refreshed STATUS, CURRENT_HANDOFF, and persistent handoff state.'
+- 'PR #823 hardened merge-if-green head/base pinning: the command validates the target
+  base branch, requires a PR head SHA, passes --match-head-commit to GitHub, and renders
+  checked base/head refs in the command output.'
+- 'PR #821 hardened merge-if-green postconditions: after a successful merge, the command
+  verifies the merge commit on main, waits for main CI, and fails the command result
+  unless main CI is green.'
+- 'PR #819 hardened next-turn PR status failed-log diagnostics: red CI now exposes
+  failed check names, GitHub Actions run ids, exact gh run view --log-failed commands,
+  bounded log-fetch status, and no-checks classification for empty rollups.'
+- 'PR #817 hardened PASS_ALREADY_DONE target-state classification: generic already-exists
+  output is no longer sufficient success evidence; target-specific classes and hard-failure
+  precedence are test-backed.'
+- 'PR #815 hardened release-prep atomicity and remote release readiness: release-prep
+  stops before metadata patching on main/branch failures; release-check and release-preflight
+  block release readiness on remote WARN; release-publish blocks inconclusive remote
+  lookups before tagging.'
+- 'PR #813 published v0.4.3 and post-release verification found Zenodo version DOI
+  10.5281/zenodo.20393329; evidence: docs/reports/terminal/20260526-120216_v043-release-verify.log.'
+- 'PR #791 merged Protected Change Planner A1 and verified it via docs/reports/terminal/protected-change-planner-a1-merge-verify.log.'
+- 'PR #763 refreshed status and handoff after the PR762 direct-coverage closeout.'
+- 'PR #764 added explicit rule-registry direct coverage completion reporting for JSON
+  and human CLI reports.'
+- 'PR #766 recorded the accepted rule-registry improvement backlog before the v0.4.2
+  safety release.'
+current_capabilities:
+  ns_actions:
+  - agent-next
+  - agent-run
+  - command-inbox-check
+  - state-freshness-check
+  - terminal-remote-preflight
+  - terminal-finalize
+  - handoff-show
+  - handoff-check
+  - governance-check
+  - rule-registry check
+  - rule-registry report
+  - patch-preflight
+  - dev
+  artifact_dirs:
+    terminal_logs: docs/reports/terminal
+    command_runs: docs/reports/command_runs
+  rule_preservation:
+    registry: .agentic/rule_preservation.yaml
+    guard: src/agentic_project_kit/rule_preservation.py
+    workflow_guard_pattern: rule-preservation-drift
+    status: baseline-active
+  documentation_registry:
+    registry: docs/DOCUMENTATION_REGISTRY.yaml
+    contract: docs/governance/DOCUMENTATION_REGISTRY_CONTRACT.md
+    cli_summary: agentic-kit docs-registry
+    cli_report: agentic-kit docs-registry --report PATH
+    artifact_policy_source: .agentic/communication_artifacts.yaml
+    broad_migration_allowed: false
+  governed_rule_registry:
+    mechanism_inventory: .agentic/rule_mechanism_inventory.yaml
+    migration_map: .agentic/rule_migrations.yaml
+    test_coverage: .agentic/rule_test_coverage.yaml
+    direct_test_plan: .agentic/rule_direct_test_plan.yaml
+    validator: src/agentic_project_kit/rule_registry_validator.py
+    cli: agentic-kit rule-registry check
+    report_cli: agentic-kit rule-registry report
+    report_completion_field: summary.direct_coverage_complete
+    workflow_guard_pattern: rule-registry-drift
+    patch_preflight: true
+    status: completion-reporting-closed
+    mechanisms:
+    - summary-renderer
+    - execution-mode-switch
+    - rule-preservation-guard
+    - workflow-guard
+    - patch-preflight
+    - chat-communication-rules
+    - chat-bootstrap-drift-rules
+    - portable-execution-rules
+    - evidence-guard
+    - typed-work-order-runner
+    - release-state-validation
+    - post-release-archive-check
+    required_fields:
+    - category
+    - priority
+    - enforcement_phase
+    - owner
+    - conflict_domains
+    - surfaces
+    - tests
+    compatibility_checks:
+    - category/enforcement_phase matrix
+    - ambiguous category/priority/enforcement_phase rejection
+    completeness_checks:
+    - known_legacy_rule_ids index
+    - migration entry for every known legacy rule
+    - every migration entry indexed
+    - migrated/archived/rejected disposition statuses
+    coverage_checks:
+    - test coverage classification for every active mechanism
+    - direct-test path validation
+    - empty direct-test follow-up plan after PR762
+    reporting_checks:
+    - explicit JSON direct_coverage_complete field after PR764
+    - explicit human completion_status line after PR764
+  workflow_hardening:
+    remote_route_rule: GitHub connector direct-path-first for known paths, refs, PRs,
+      and commits.
+    yaml_mutation_rule: Use structured YAML mutation and parse validation.
+    control_file_preservation: .agentic/control_file_preservation.yaml protects active
+      rules from lossy shortening.
+  gui_mvp:
+    status: closed_out_on_main
+    verified_read_only_actions:
+    - cockpit-readiness
+    - doctor
+    - check-docs
+    disabled_actions:
+    - agent-run
+    - remote_mutation
+    - destructive_actions
+policies:
+  no_copy_terminal_policy: .agentic/no_copy_terminal_policy.yaml
+  control_file_preservation: .agentic/control_file_preservation.yaml
+  test_bound_anchors:
+  - use d for log-backed PASS and f for log-backed FAIL
+  - nested quote-based code generation
+  - nested shell/Python quote layers
+rules:
+- id: remote-first-no-guess
+  status: active
+  text: Do not guess repository state, command syntax, file locations, release phase,
+    GitHub JSON fields, or available evidence. Inspect the remote repository, command
+    help, known paths, PRs, commits, logs, and authoritative repo files before acting.
+- id: quality-first-no-shortcuts
+  status: active
+  text: Prefer deterministic, test-backed, maintainable fixes over quick patches.
+    No shortcuts, workaround-only fixes, or chat-only promises for recurring workflow
+    defects.
+- id: patch-artifact-preflight-before-application
+  status: active
+  text: Before applying generated patch artifacts, run patch-artifact preflight diagnostics
+    and fail on unsafe quoting, ambiguous YAML terms, or control-file weakening.
+- id: generated-code-syntax-first
+  status: active
+  text: Generated shell and Python artifacts must be syntax-checked before execution
+    or commit; generated code cannot be trusted because it looks plausible.
+- id: coverage-yaml-terms-must-be-strings
+  status: active
+  text: Coverage YAML required terms must stay strings; colon-containing terms must
+    be quoted or written through structured YAML writers.
+- id: final-summary-self-validation
+  status: active
+  text: Final summaries must be self-validated against preceding output before treating
+    a block as successful.
+- id: no-copy-terminal-evidence
+  status: active
+  text: Routine PASS and normal FAIL handoffs must be backed by repo evidence; use
+    d for log-backed PASS and f for log-backed FAIL. Manual terminal paste is only
+    for hard failure, broken logging, unavailable evidence, unusable evidence, or
+    explicit user request.
+- id: remote-log-lookup-first
+  status: active
+  text: Remote evidence must be inspected first for FAIL or uncertain handoffs; direct-fetch
+    docs/reports/terminal logs before asking for paste-output unless logging is broken
+    or unavailable. The phrase remote evidence is intentionally preserved for rule-preservation
+    coverage.
+- id: rules-must-be-test-backed
+  status: active
+  text: Durable workflow rules need a stable repository home, documentation, and deterministic
+    tests or guards that fail when the rule disappears or is weakened.
+- id: yaml-structured-mutation-only
+  status: active
+  text: YAML governance files must be changed through parse-modify-dump or equivalent
+    structured mutation, then parsed again before gates.
+- id: github-connector-direct-path-first
+  status: active
+  text: For remote GitHub work with known paths, refs, or commits, use direct fetch,
+    update, and PR APIs before search.
+- id: control-file-preservation
+  status: active
+  text: Protected control files must preserve active rules and required anchors. Information
+    preservation outranks compactness; hard length-limit trimming is forbidden.
+- id: structured-summary-must-be-enforced
+  status: active
+  text: Relevant local or remote work blocks must end with the canonical structured
+    SUMMARY from FINAL_SUMMARY_CONTRACT.md. Missing, malformed, contradictory, or
+    legacy summaries are workflow drift.
+- id: governed-rule-registry-before-documentation-rebuild
+  status: active
+  text: A governed modular rule registry must become the canonical source of truth
+    before documentation-management rebuild work resumes.
+recent_failure_patterns:
+- id: guessing-before-inspection
+  prevention: Before choosing commands, paths, JSON fields, release checks, or DOI
+    sources, inspect the remote repository and command help. Treat memory and chat
+    summaries as hypotheses until verified.
+- id: interpreter-discovery-before-python
+  prevention: Discover the active interpreter and project environment before invoking
+    python, python3, pytest, ruff, or agentic-kit; prefer .venv/bin/python when the
+    project venv exists; avoid naked python; when wrapping shell commands, avoid assuming
+    set -e behavior unless explicitly set and logged.
+- id: global-cli-or-venv-assumption
+  prevention: Do not assume global CLIs or an existing venv; use project-local discovery
+    and documented bootstrap paths.
+- id: nested-triple-quote-code-generator
+  prevention: Avoid nested quote-based code generation, nested shell/Python quote
+    layers, nested triple-quoted string literals, and nested triple quotes in generated
+    patch scripts; prefer line-list generation, existing helper scripts, simple file
+    writes, or structured update APIs.
+- id: yaml-colon-term-reinterpreted-as-mapping
+  prevention: Quote colon-containing YAML terms or use structured YAML writers so
+    plain scalars are not reinterpreted as mappings.
+- id: standard-error-guards
+  prevention: Recurring workflow errors must become deterministic guards, tests, or
+    documented failure patterns.
+- id: interactive-terminal-exit
+  prevention: Chat-pasted terminal blocks must not end by closing the user terminal;
+    avoid top-level exit and exec unless explicitly requested.
+- id: stale-successor-handoff-prompt-after-main-merge
+  prevention: Refresh STATUS, handoff_state, CURRENT_HANDOFF, and successor prompt
+    before treating handoff prose as authoritative.
+- id: repeated-yaml-governance-file-corruption
+  prevention: Parse YAML before and after mutation and use a structured writer.
+- id: final-pass-after-inner-fail
+  prevention: Final summaries must distinguish work result from evidence result; evidence
+    upload must not relabel failed work as PASS.
+- id: lossy-control-file-shortening
+  prevention: Do not shorten protected control files by deleting active rules; use
+    successors, generated projections, or split/reference patterns.
+- id: structured-summary-drift
+  prevention: Verify canonical SUMMARY fields and consistency across WORK, EVIDENCE,
+    OVERALL, REMOTE_EVIDENCE, terminal_log, command_report, CHAT_REPLY, and RESULT
+    marker.
+next_allowed_tasks:
+- id: readme-release-history-extraction-follow-up
+  title: Continue only with the next smallest README release-history extraction follow-up
+    if README size or DOI-history drift reappears.
+  priority: 1
+- id: inspect-selected-dead-code-slice
+  title: Remove or justify inspect_selected() dead code in one isolated, test-backed
+    slice.
+  priority: 2
+- id: doctor-absolute-path-gate-slice
+  title: Add the missing doctor gate for absolute path leakage in one isolated, test-backed
+    slice.
+  priority: 3
+- id: cockpit-action-result-enum-slice
+  title: Replace CockpitActionResult string literal result constants with an enum
+    in one isolated, test-backed slice.
+  priority: 4
+- id: b11-gatekeeper-core
+  title: 'Implement B11 Gatekeeper Core before GUI work: machine-readable READY/WAIT/BLOCKED/FAILED
+    state model, next_action, allowed actions, button enablement contract, safe GitHub/PR/CI
+    checks, race-condition handling, automatic log/evidence classification, no-copy
+    transfer path, and hardened handoff-prompt preparation command.'
+  priority: 1
+- id: tkinter-workbench-gui-slice-1
+  title: Resume the smallest Tkinter workbench GUI slice only after B11 Gatekeeper
+    Core state/action contract is test-backed and current-state/handoff freshness
+    are clean.
+  priority: 5
+blocked_until_closeout:
+- Remote/destructive GUI actions
+- Large GUI architecture expansion before successor-chat bootstrap
+- Broad documentation migration during release/evidence-kernel hardening closeouts
+- Release, tag, or DOI mutation
+- GUI product work before post-PR880 bootstrap refresh is merged and verified
+- Broad GUI implementation before the deterministic gatekeeper read-only inspection
+  slice
+- Gatekeeper product work before post-PR883 handoff refresh is merged and verified
+- Treating helper-local PASS as slice PASS before repository governance gates pass
+- Gatekeeper product work before post-PR886 handoff refresh is merged and verified
+- Treating helper-local PASS as slice PASS without slice-gate evidence
+- Gatekeeper product work before post-PR888 handoff refresh is merged and verified
+- Treating helper-local PASS as slice PASS without patch-preflight slice-gate evidence
+- GUI implementation before B11 Gatekeeper Core state/action contract is test-backed
+first_instruction: 'Review PR #1436 and the refreshed successor handoff package for
+  the release command authority planning slice. After merge, start from fresh main
+  and use centralized historical record docs/planning/PROJECT_DIRECTION.yaml#release-command-authority-slice
+  before DOI, legacy-doc, absolute-path, or GUI work.'
+handoff_maintenance:
+  principle: curated-not-accumulated
+  update_required_at_chat_end: true
+  no_redundant_rules: true
+  no_contradictory_rules: true
+  remove_obsolete_rules_when_system_changes: true
+  latest_successor_prompt: docs/reports/terminal/post-pr2187-successor-chat-handoff.md
+  first_instruction: 'Review PR #1436 and the refreshed successor handoff package
+    for the release command authority planning slice. After merge, start from fresh
+    main and use centralized historical record docs/planning/PROJECT_DIRECTION.yaml#release-command-authority-slice
+    before DOI, legacy-doc, absolute-path, or GUI work.'
+next_step:
+  first_instruction: 'Review PR #1436 and the refreshed successor handoff package
+    for the release command authority planning slice. After merge, start from fresh
+    main and use centralized historical record docs/planning/PROJECT_DIRECTION.yaml#release-command-authority-slice
+    before DOI, legacy-doc, absolute-path, or GUI work.'
+evidence:
+  latest_successor_prompt: docs/reports/terminal/post-pr2187-successor-chat-handoff.md
+# preservation-anchor: use d for log-backed PASS and f for log-backed FAIL
+# preservation-anchor: nested shell/Python quote layers

agentic_project_kit-1.0.6/.agentic/operational_handoff_state.yaml

@@ -0,0 +1,30 @@
+schema_version: 1
+current_head:
+  full: 4e30f785d7d90ec543def331b5e74ae09b99c294
+  short: 4e30f785
+  subject: Prepare release v1.0.6 (#2187)
+last_substantive_work_state:
+  full: 4e30f785d7d90ec543def331b5e74ae09b99c294
+  short: 4e30f785
+  subject: Prepare release v1.0.6 (#2187)
+administrative_context:
+  - "PR #1257 hardened admin-refresh-pr and pr-complete recovery."
+  - "PR #1255 added generated operational handoff block replacement."
+  - "PR #1253 added generated operational handoff block markers."
+  - "PR #1250 refreshed the post-PR1249 operational handoff state and successor prompt markers."
+  - "PR #1250 refreshed the operational handoff state after PR #1249 and preserved the first generated bootstrap projection path."
+  - "PR #1248 fixes the administrative handoff refresh loop for loop-fix squash commits."
+  - "PR #1247 accepts administrative handoff squash refresh heads."
+  - "PR #1246 refreshed operational handoff after PR #1245."
+  - "PR #1245 is an administrative handoff/evidence refresh after PR #1244."
+freshness_policy:
+  text: >-
+    A successor chat must treat operational documentation freshness as part of
+    handoff freshness: STATUS, CURRENT_HANDOFF, START_NEW_CHAT_PROMPT,
+    NEXT_CHAT_BOOTSTRAP, and the active roadmap must mention current safe/admin
+    markers before they are used as authoritative orientation.
+next_safe_substantive_slice:
+  text: >-
+    Continue with the next governed DPA DP2 slice from fresh main after
+    post-merge closeout reports NOOP. Preserve the WRT-CH-001 generated-block
+    boundary and do not manually patch generated successor handoff projections.

agentic_project_kit-1.0.6/.github/workflows/ci.yml

@@ -0,0 +1,43 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: ci-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Ruff
+        run: ruff check .
+
+      - name: Tests
+        run: python -m pytest -q
+
+      - name: CLI smoke
+        run: |
+          agentic-kit --help
+          agentic-kit todo --help

agentic_project_kit-1.0.6/.github/workflows/pages.yml

@@ -0,0 +1,96 @@
+name: Pages
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  pages-state:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    outputs:
+      deploy-ready: ${{ steps.pages.outputs.deploy-ready }}
+
+    steps:
+      - id: pages
+        uses: actions/github-script@v8
+        with:
+          script: |
+            try {
+              const response = await github.request(
+                "GET /repos/{owner}/{repo}/pages",
+                context.repo
+              );
+              const buildType = response.data.build_type || "";
+              const deployReady = buildType === "workflow";
+              if (!deployReady) {
+                core.notice("GitHub Pages exists but is not configured for GitHub Actions deployment.");
+              }
+              core.setOutput("deploy-ready", String(deployReady));
+            } catch (error) {
+              if (error.status === 404) {
+                core.notice("GitHub Pages is not enabled yet; skipping deployment after a successful build.");
+                core.setOutput("deploy-ready", "false");
+                return;
+              }
+              throw error;
+            }
+
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    needs: pages-state
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+          cache: "pip"
+
+      - name: Install package
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Build generated site
+        run: python site/scripts/build.py --output site/dist --json
+
+      - name: Site tests
+        run: python -m pytest tests/test_site_generator.py tests/test_site_claims.py -q
+
+      - uses: actions/configure-pages@v5
+        if: needs.pages-state.outputs.deploy-ready == 'true'
+
+      - uses: actions/upload-pages-artifact@v3
+        if: needs.pages-state.outputs.deploy-ready == 'true'
+        with:
+          path: site/dist
+
+  deploy:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    needs:
+      - pages-state
+      - build
+    if: needs.pages-state.outputs.deploy-ready == 'true'
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4