intent-history 7.6.7__tar.gz

intent_history-7.6.7/.claude-plugin/marketplace.json

@@ -0,0 +1,25 @@
+{
+  "name": "intent",
+  "owner": {
+    "name": "Zeng Deyang"
+  },
+  "metadata": {
+    "description": "Intent semantic history for agent-driven development."
+  },
+  "plugins": [
+    {
+      "name": "intent-cli",
+      "description": "Instructions for quiet, continuous Intent semantic maintenance with the itt CLI. Ships the Skill only: no hooks, and no project is enabled by installing it.",
+      "source": "./",
+      "homepage": "https://github.com/dozybot001/Intent",
+      "repository": "https://github.com/dozybot001/Intent",
+      "license": "MIT",
+      "keywords": [
+        "intent",
+        "semantic-history",
+        "agent",
+        "continuation"
+      ]
+    }
+  ]
+}

intent_history-7.6.7/.dockerignore

@@ -0,0 +1,21 @@
+.git
+.venv
+.pytest_cache
+.intent
+.inthub
+build
+dist
+__pycache__
+*.pyc
+*.pyo
+*.egg-info
+htmlcov
+.github
+.claude
+.codex
+deploy
+docs
+scripts
+tests
+SKILL.md
+SKILL_CN.md

intent_history-7.6.7/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,29 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior:
+
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting the maintainers. All complaints will be reviewed and investigated.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

intent_history-7.6.7/.github/CONTRIBUTING.md

@@ -0,0 +1,68 @@
+# Contributing to Intent
+
+Thanks for your interest in contributing to Intent.
+
+## Getting Started
+
+```bash
+git clone https://github.com/dozybot001/Intent.git
+cd Intent
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[server,release]"   # IntHub server dependencies + pytest
+```
+
+Run tests before opening a PR (Node.js is needed for the web UI logic tests):
+
+```bash
+python -m pytest -q                # the full suite
+python scripts/changed_tests.py    # only the tests your uncommitted changes affect
+```
+
+Pass a commit, such as `python scripts/changed_tests.py HEAD~2`, to include what changed since then.
+
+PostgreSQL integration tests are skipped unless `INTHUB_TEST_POSTGRES_URL` points at a disposable database, for example one started with `docker run --rm -e POSTGRES_PASSWORD=test -p 5432:5432 postgres`.
+
+To work on the agent skill locally, install it from your checkout with `npx skills add ./ -g -a claude-code -a codex`.
+
+## Development Workflow
+
+This repo dogfoods Intent, and maintainers record milestones with `itt`.
+You don't need to use Intent to contribute.
+If you want to try it, `itt inspect` shows the current state.
+`.intent/` is not in Git, so run `itt init` first in a fresh clone.
+
+## Reporting Bugs
+
+Open a [GitHub issue](https://github.com/dozybot001/Intent/issues/new?template=bug_report.md) with:
+
+- What you expected to happen
+- What actually happened
+- The `itt` command and its JSON output
+- Your Python version and OS
+
+## Submitting Changes
+
+1. Fork the repo and create a branch
+2. Make your changes and add tests when behavior changes
+3. Run `python -m pytest -q` and confirm all tests pass
+4. Open a pull request with a clear description
+
+## Project Structure
+
+```text
+src/intent_cli/       CLI (`itt`), standard library only
+apps/inthub_api/      IntHub server: API, auth, history storage
+apps/inthub_web/      IntHub web app (static, no build step)
+apps/inthub_local/    `itt hub start` launcher for a local IntHub
+SKILL.md, references/ Agent skill and its on-demand references
+scripts/              Installers and the skill's argv adapter
+deploy/inthub/        Production release tooling (maintainers)
+docs/                 User documentation (EN and CN)
+tests/                Test suite (pytest + Node logic tests)
+```
+
+## Code Style
+
+- Keep it simple. Don't over-engineer.
+- No external dependencies for the CLI.
+- Add tests for new commands and behavior changes.

intent_history-7.6.7/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,38 @@
+---
+name: Bug Report
+about: Report a bug in the Intent CLI or IntHub
+title: "[Bug] "
+labels: bug
+assignees: ''
+---
+
+## Describe the bug
+
+Describe the bug clearly.
+
+## To reproduce
+
+List the steps or `itt` commands needed to reproduce it.
+
+```bash
+itt <command>
+```
+
+## Expected behavior
+
+What did you expect to happen?
+
+## Actual behavior
+
+What actually happened? Paste the JSON output if applicable.
+
+```json
+
+```
+
+## Environment
+
+- OS:
+- Python version:
+- Intent version (`itt version`):
+- Agent (if applicable): Claude Code / Cursor / Codex / other

intent_history-7.6.7/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,31 @@
+---
+name: Feature Request
+about: Suggest an idea for Intent
+title: "[Feature] "
+labels: enhancement
+assignees: ''
+---
+
+## Problem
+
+What problem does this feature solve?
+
+## Proposed solution
+
+Describe the feature or change you would like to see.
+
+## Affected area
+
+- [ ] Intent CLI
+- [ ] IntHub Local
+- [ ] Agent skill
+- [ ] Documentation
+- [ ] Other
+
+## Alternatives considered
+
+Any alternative solutions or approaches you have considered.
+
+## Additional context
+
+Any extra context, examples, or references.

intent_history-7.6.7/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+Please fill this out in English.
+
+## What does this PR do?
+
+Brief description of the change.
+
+## Type
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Refactoring
+- [ ] Documentation
+- [ ] Skill / tooling update
+
+## Checklist
+
+- [ ] `python -m pytest -q` passes when behavior changed
+- [ ] Tested manually with `itt <relevant commands>` when applicable
+- [ ] Documentation updated when behavior or UX changed
+
+## Related
+
+Link to issue, intent ID, or decision ID if applicable.

intent_history-7.6.7/.github/SECURITY.md

@@ -0,0 +1,29 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported |
+| ------- | --------- |
+| 7.x     | :white_check_mark: |
+| < 7.0   | :x: |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in Intent CLI or IntHub, report it privately through [GitHub's private vulnerability reporting](https://github.com/dozybot001/Intent/security/advisories/new) (repository **Security** tab → **Report a vulnerability**). Do not disclose user data, credentials, or an unpatched exploit in a public issue. Public, non-sensitive hardening suggestions may use the regular issue tracker directly.
+
+We will acknowledge reports within 7 days and provide an update on the fix timeline.
+
+## Scope
+
+- **Intent CLI** (`itt`): runs locally, reads and writes `.intent/` JSON files, and communicates with IntHub via HTTP.
+- **`.intent/` data**: may contain goals, implementation rationale, decisions, repository metadata, and an IntHub configuration. `itt init` adds `.intent/` to that clone's Git-local `.git/info/exclude` and reports a warning if it cannot; it does not edit the shared `.gitignore`. Users should still review the directory before sharing it or staging ignored files explicitly.
+- **Hub credentials**: `itt auth login` stores an account access token through Git's configured credential helper, scoped to one IntHub endpoint; its protection is that helper's (for example the macOS Keychain, or plaintext with `credential.helper=store`). `--token` and `INTHUB_TOKEN` are never persisted and are only sent to the endpoint given on the command line, the user-level endpoint, or loopback, never to an endpoint named only by a shared `.intent/hub.json`. Remote IntHub URLs must use HTTPS. Tokens never enter `.intent/`.
+- **IntHub Local**: binds to `127.0.0.1` by default and stores synchronized snapshots in an unencrypted SQLite database under `~/.inthub/inthub.db` unless configured otherwise.
+
+## IntHub Local Trust Boundary
+
+The bundled IntHub Local service is a single-user browser and read model for a trusted machine. It has no accounts: anything that can reach it can read and write its history. To keep other websites in your browser out, it answers only same-origin requests on loopback host names (no CORS headers, `Host` checked against 127.0.0.1/localhost to defeat DNS rebinding, JSON-only request bodies), and the server refuses to start unauthenticated on a non-loopback interface. It does not provide transport security or encryption at rest.
+
+Do not bind IntHub Local to a LAN or public interface or publish it through a reverse proxy. For remote or multi-user use, deploy the authenticated profile instead.
+
+The hosted service (https://inthub.tenon.asia) uses that authenticated profile: Tenon OIDC sign-in (PKCE, nonce, single-use state), host-only `Secure` `SameSite=Strict` session cookies, per-account history isolation, account access tokens that are stored as hashes and can be revoked, same-origin checks on browser writes, a strict Content-Security-Policy, and PostgreSQL bound to a private network behind TLS. Browser sessions are read-only for history; only account access tokens can push. Revoke a token from the account menu after any suspected disclosure.

intent_history-7.6.7/.github/workflows/monitor.yml

@@ -0,0 +1,29 @@
+# Probes the hosted IntHub from outside its server. A failed run emails the
+# repository owner, so nothing here needs an account or a secret.
+name: monitor
+
+on:
+  schedule:
+    - cron: "*/30 * * * *"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  probe:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    env:
+      CURL: curl --fail --silent --show-error --max-time 20 --retry 3 --retry-delay 30 --retry-all-errors
+    steps:
+      - name: Service is ready
+        run: $CURL https://inthub.tenon.asia/readyz
+
+      - name: Disk and backups are healthy
+        run: |
+          status="$($CURL https://inthub.tenon.asia/status.json)"
+          echo "$status"
+          oldest="$(date -u -d '2 hours ago' +%Y-%m-%dT%H:%M:%SZ)"
+          echo "$status" | jq -e --arg oldest "$oldest" \
+            '.disk == "ok" and .backup == "ok" and .offsite == "ok" and .checked_at >= $oldest'

intent_history-7.6.7/.github/workflows/publish.yml

@@ -0,0 +1,37 @@
+# Publishes a release to PyPI through trusted publishing, so no token is stored.
+# Runs after a GitHub release goes out, which the release procedure does last.
+# To publish an existing tag by hand: gh workflow run publish.yml -f tag=vX.Y.Z
+name: publish
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: Tag to publish, such as v7.6.6
+        required: true
+
+permissions:
+  contents: read
+
+jobs:
+  pypi:
+    # Set the repository variable PYPI_ENABLED once PyPI trusts this workflow.
+    if: github.event_name == 'workflow_dispatch' || vars.PYPI_ENABLED == 'true'
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+        with:
+          ref: ${{ inputs.tag || github.event.release.tag_name }}
+          fetch-depth: 0
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: "3.13"
+      - run: python -m pip install --quiet build
+      - run: python -m build
+      - uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3

intent_history-7.6.7/.github/workflows/test.yml

@@ -0,0 +1,58 @@
+# Test-only CI. Production releases never read from GitHub.
+name: tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: tests-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  pytest:
+    name: pytest (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-24.04
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        # 3.9: requires-python floor; 3.13: production image; 3.14: release qualification.
+        python-version: ["3.9", "3.13", "3.14"]
+    services:
+      postgres:
+        # postgres:18.4-bookworm, the digest pinned in deploy/inthub/runtime-images.lock.json
+        image: postgres@sha256:16fa100a3a6e92c0556632870455e7f8c6f3df5cefddd67d6b95292732bd7ff0
+        env:
+          POSTGRES_DB: inthub_test
+          POSTGRES_USER: inthub_test
+          POSTGRES_PASSWORD: inthub_test_password
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd "pg_isready -U inthub_test -d inthub_test"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 12
+    env:
+      INTHUB_TEST_POSTGRES_URL: postgresql://inthub_test:inthub_test_password@127.0.0.1:5432/inthub_test
+      PIP_DISABLE_PIP_VERSION_CHECK: "1"
+    steps:
+      - uses: actions/checkout@d23441a48e516b6c34aea4fa41551a30e30af803 # v6.1.0
+        with:
+          fetch-depth: 0 # setuptools-scm derives the version from tags
+          persist-credentials: false
+      - uses: actions/setup-python@ece7cb06caefa5fff74198d8649806c4678c61a1 # v6.3.0
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install package with server and test extras
+        run: python -m pip install ".[server,release]"
+      - name: Run tests
+        run: python -m pytest -q -ra -n auto
+      - name: Smoke-test the installed CLI
+        run: itt version

intent_history-7.6.7/.gitignore

@@ -0,0 +1,45 @@
+# Historical materials not meant for the main repo
+backup/
+
+# Local Intent workspace metadata; do not commit to Git
+.intent/
+
+# Local IntHub runtime state; do not commit to Git
+.inthub/
+
+# Claude Code local settings and personal workspace overrides
+.claude/
+
+# Editor settings
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Logs and temp files
+*.log
+*.tmp
+__pycache__/
+.coverage
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+htmlcov/
+
+# Python environments and packaging
+.venv/
+venv/
+dist/
+build/
+*.egg-info/
+
+# Local secrets
+.env
+*.env
+!deploy/inthub/inthub.env.example
+
+# OS-generated files
+.DS_Store
+Thumbs.db
+Desktop.ini

intent_history-7.6.7/Dockerfile

@@ -0,0 +1,46 @@
+# Release images are Linux/amd64 only. Pin the exact platform manifest so the
+# same Git commit cannot silently pick up a different Python or Debian base.
+FROM python:3.13-slim@sha256:69e18bd8d831d88e0ef70239dc7771ab7c28bc296ae78ac75cde71e60aa4434f
+
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PYTHONPATH=/app/src
+
+WORKDIR /app
+
+RUN groupadd --gid 10001 inthub \
+    && useradd --uid 10001 --gid inthub --no-create-home --shell /usr/sbin/nologin inthub \
+    && mkdir -p /data \
+    && chown inthub:inthub /data
+
+# The pinned binary wheel carries libpq, eliminating a floating apt snapshot
+# from the release recipe while retaining an exact application dependency.
+RUN python -m pip install --no-cache-dir --index-url https://mirrors.cloud.tencent.com/pypi/simple "psycopg[binary]==3.3.4" "Authlib==1.9.1" "httpx==0.28.1"
+
+COPY --chown=inthub:inthub . /app
+
+# Keep revision-specific metadata after the dependency layer so a new release
+# can reuse the already downloaded PostgreSQL driver.
+ARG INTHUB_VERSION=0.0.0
+ARG INTHUB_REVISION=unknown
+ARG INTHUB_SCHEMA_VERSION=4
+ENV INTHUB_VERSION=${INTHUB_VERSION}
+LABEL org.opencontainers.image.title="IntHub" \
+    org.opencontainers.image.source="https://gitee.com/dozybot/Intent" \
+    org.opencontainers.image.version="${INTHUB_VERSION}" \
+    org.opencontainers.image.revision="${INTHUB_REVISION}" \
+    io.inthub.database-schema-version="${INTHUB_SCHEMA_VERSION}"
+
+USER 10001:10001
+
+EXPOSE 8000
+
+ENV INTHUB_HOST=0.0.0.0 \
+    INTHUB_PORT=8000 \
+    INTHUB_DB_PATH=/data/inthub.db \
+    INTHUB_SERVE_WEB=1
+
+HEALTHCHECK --interval=15s --timeout=5s --start-period=20s --retries=4 \
+    CMD ["python", "-c", "import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/readyz', timeout=3).read()"]
+
+CMD ["python", "-m", "apps.inthub_api"]

intent_history-7.6.7/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zeng Deyang
+
+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.