cellin 0.1.1__tar.gz

cellin-0.1.1/.github/ISSUE_TEMPLATE/architecture_proposal.yml

@@ -0,0 +1,49 @@
+name: Architecture or design issue
+description: Capture a boundary problem, design debt item, or structural change.
+title: "[Architecture]: "
+labels: ["architecture"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this for confirmed boundary problems, coupling issues, or design changes.
+
+  - type: textarea
+    id: seam
+    attributes:
+      label: Affected boundary or seam
+      description: Which subsystem boundary or design contract is the issue about?
+    validations:
+      required: true
+
+  - type: textarea
+    id: current_problem
+    attributes:
+      label: Current problem
+      description: What is structurally wrong or expensive today?
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence
+      description: Commands, metrics, traces, or examples that show the problem.
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposed_direction
+    attributes:
+      label: Proposed direction
+      description: What boundary, ownership, or architecture change should happen?
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: What outcome or simplification would close this issue?
+      placeholder: |
+        - [ ] ...
+        - [ ] ...

cellin-0.1.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,70 @@
+name: Bug report
+description: Report a reproducible problem with Cellin.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug.
+        Please provide enough detail to reproduce and verify a fix.
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened?
+      placeholder: A short description of the bug.
+    validations:
+      required: true
+
+  - type: textarea
+    id: repro_steps
+    attributes:
+      label: Reproduction steps
+      description: Exact commands, fixtures, and environment details needed to reproduce.
+      placeholder: |
+        1. ...
+        2. ...
+        3. ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Logs and output
+      description: Paste CLI output, stack traces, or relevant JSON snippets.
+      render: shell
+
+  - type: input
+    id: version
+    attributes:
+      label: Version or commit
+      description: Git SHA, tag, or package version.
+      placeholder: e.g. 0.1.1 or 76aa2a1
+    validations:
+      required: true
+
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: OS, Python version, and relevant tooling versions.
+      placeholder: e.g. macOS 15, Python 3.12.10, uv 0.7.x
+    validations:
+      required: true

cellin-0.1.1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Report a security issue privately
+    url: https://github.com/ben-ranford/cellin/security/advisories/new
+    about: Use a private security advisory instead of a public issue.

cellin-0.1.1/.github/ISSUE_TEMPLATE/documentation_request.yml

@@ -0,0 +1,35 @@
+name: Documentation issue
+description: Report missing, outdated, or unclear documentation.
+title: "[Docs]: "
+labels: ["documentation"]
+body:
+  - type: textarea
+    id: gap
+    attributes:
+      label: Documentation gap
+      description: What is missing, unclear, or incorrect?
+    validations:
+      required: true
+
+  - type: textarea
+    id: audience
+    attributes:
+      label: Affected audience
+      description: Who is blocked or confused by this gap?
+    validations:
+      required: true
+
+  - type: textarea
+    id: sources
+    attributes:
+      label: Source material
+      description: Code paths, commands, examples, or screenshots that the docs should reflect.
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: What should a reader be able to do after this is fixed?
+      placeholder: |
+        - [ ] ...
+        - [ ] ...

cellin-0.1.1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,48 @@
+name: Feature request
+description: Propose an improvement or new capability.
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the idea.
+        Focus on user problem, expected behavior, and success criteria.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: What user pain does this solve?
+      placeholder: As a ..., I need ... because ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe behavior, CLI changes, APIs, or UX.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Other options and why they are less suitable.
+
+  - type: textarea
+    id: impact
+    attributes:
+      label: Impact and scope
+      description: Affected runtime surfaces, docs, tests, performance, or compatibility.
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: What must be true for this to be considered done?
+      placeholder: |
+        - [ ] ...
+        - [ ] ...

cellin-0.1.1/.github/ISSUE_TEMPLATE/performance_issue.yml

@@ -0,0 +1,51 @@
+name: Performance or efficiency issue
+description: Report a measured slowdown, waste pattern, or inefficiency.
+title: "[Performance]: "
+labels: ["performance"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this for measured regressions or confirmed waste patterns.
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What is slow or wasteful?
+    validations:
+      required: true
+
+  - type: textarea
+    id: workload
+    attributes:
+      label: Workload or scenario
+      description: Which command, fixture, or corpus shows the problem?
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence
+      description: Include timings, counts, ratios, or profiling output.
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: impact
+    attributes:
+      label: User or system impact
+      description: Latency, CPU, memory, write amplification, or token cost impact.
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: What measurable improvement should close this issue?
+      placeholder: |
+        - [ ] ...
+        - [ ] ...

cellin-0.1.1/.github/ISSUE_TEMPLATE/refactor_hotspot.yml

@@ -0,0 +1,49 @@
+name: Refactor hotspot
+description: Capture a verified maintainability hotspot or cleanup seam.
+title: "[Refactor]: "
+labels: ["refactor"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Use this for hotspots backed by concrete evidence, not just a large file or a vague smell.
+
+  - type: textarea
+    id: hotspot
+    attributes:
+      label: Hotspot summary
+      description: Which file, module, or seam is costly to change?
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence of change pain
+      description: Include churn, complexity, duplication, fan-in, or test-friction evidence.
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: target
+    attributes:
+      label: Proposed refactor target
+      description: What narrower seam or ownership change would reduce the cost?
+    validations:
+      required: true
+
+  - type: textarea
+    id: non_goals
+    attributes:
+      label: Non-goals
+      description: What should not be expanded into this refactor?
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: What will be simpler or safer after the refactor?
+      placeholder: |
+        - [ ] ...
+        - [ ] ...

cellin-0.1.1/.github/ISSUE_TEMPLATE/repo_rigor.yml

@@ -0,0 +1,46 @@
+name: Repo rigor or automation issue
+description: Capture CI, release, governance, or workflow hardening work.
+title: "[Rigor]: "
+labels: ["rigor-uplift"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What repo hygiene, automation, or governance gap exists?
+    validations:
+      required: true
+
+  - type: textarea
+    id: affected_surface
+    attributes:
+      label: Affected surface
+      description: Which workflow, ruleset, hook, template, or automation is involved?
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence
+      description: Commands, workflow runs, or examples that show the gap.
+      render: shell
+    validations:
+      required: true
+
+  - type: textarea
+    id: desired_enforcement
+    attributes:
+      label: Desired enforcement or behavior
+      description: What should the repo do instead?
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: What checks or guarantees should exist when this is done?
+      placeholder: |
+        - [ ] ...
+        - [ ] ...

cellin-0.1.1/.github/PULL_REQUEST_TEMPLATE/bug_fix.md

@@ -0,0 +1,32 @@
+## Summary
+
+Describe the bug and the intended behavior after this fix.
+
+## Changes
+
+- 
+
+## Validation
+
+Commands and checks run:
+
+```bash
+make release-smoke
+```
+
+Additional targeted validation:
+
+- 
+
+## Risk and compatibility
+
+- User-visible behavior change:
+- Migration required:
+- Backward-compatibility risk:
+
+## Checklist
+
+- [ ] Reproduction or regression coverage added or updated
+- [ ] Docs or examples updated if behavior changed
+- [ ] No unrelated changes included
+- [ ] Ready for review

cellin-0.1.1/.github/PULL_REQUEST_TEMPLATE/docs.md

@@ -0,0 +1,32 @@
+## Summary
+
+Describe the documentation gap and what this PR fixes.
+
+## Changes
+
+- 
+
+## Validation
+
+Commands and checks run:
+
+```bash
+make docs
+```
+
+Additional targeted validation:
+
+- 
+
+## Documentation notes
+
+- Affected audience:
+- Related code or workflows:
+- Follow-up docs needed:
+
+## Checklist
+
+- [ ] Commands and examples were checked against the current repo
+- [ ] Screenshots or logs refreshed if needed
+- [ ] No unrelated source changes included
+- [ ] Ready for review

cellin-0.1.1/.github/PULL_REQUEST_TEMPLATE/feature.md

@@ -0,0 +1,32 @@
+## Summary
+
+Describe the user problem and the capability this change adds.
+
+## Changes
+
+- 
+
+## Validation
+
+Commands and checks run:
+
+```bash
+make release-smoke
+```
+
+Additional targeted validation:
+
+- 
+
+## Scope and compatibility
+
+- New surface area:
+- Follow-up work:
+- Breaking changes:
+
+## Checklist
+
+- [ ] Tests or evals added or updated
+- [ ] Docs, examples, or starter flows updated
+- [ ] Compatibility notes included if needed
+- [ ] Ready for review

cellin-0.1.1/.github/PULL_REQUEST_TEMPLATE/refactor.md

@@ -0,0 +1,32 @@
+## Summary
+
+Describe the hotspot or seam this refactor addresses.
+
+## Changes
+
+- 
+
+## Validation
+
+Commands and checks run:
+
+```bash
+make release-smoke
+```
+
+Additional targeted validation:
+
+- 
+
+## Refactor notes
+
+- Verified hotspot or evidence:
+- Non-goals:
+- Behavior changes:
+
+## Checklist
+
+- [ ] Existing behavior preserved or intentionally changed
+- [ ] Tests updated where seams moved
+- [ ] Docs updated if the public surface changed
+- [ ] Ready for review

cellin-0.1.1/.github/PULL_REQUEST_TEMPLATE/release_rigor.md

@@ -0,0 +1,32 @@
+## Summary
+
+Describe the release, CI, governance, or automation change.
+
+## Changes
+
+- 
+
+## Validation
+
+Commands and checks run:
+
+```bash
+make release-smoke
+```
+
+Additional targeted validation:
+
+- 
+
+## Release and enforcement notes
+
+- Workflow or ruleset impact:
+- Versioning impact:
+- Secrets or trusted publishing impact:
+
+## Checklist
+
+- [ ] Rulesets and checked-in workflow definitions stay aligned
+- [ ] Release or CI docs updated if behavior changed
+- [ ] Compatibility or rollout notes included
+- [ ] Ready for review

cellin-0.1.1/.github/PULL_REQUEST_TEMPLATE/security_fix.md

@@ -0,0 +1,32 @@
+## Summary
+
+Describe the security issue being addressed and the intended fixed behavior.
+
+## Changes
+
+- 
+
+## Validation
+
+Commands and checks run:
+
+```bash
+make release-smoke
+```
+
+Additional targeted validation:
+
+- 
+
+## Security notes
+
+- Affected trust boundary:
+- Severity and impact:
+- Disclosure or rollout considerations:
+
+## Checklist
+
+- [ ] Safe proof or regression coverage added or updated
+- [ ] Sensitive details handled appropriately
+- [ ] Docs or operator guidance updated if needed
+- [ ] Ready for review

cellin-0.1.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,33 @@
+## Summary
+
+Describe the problem and the intent of this change.
+
+## Changes
+
+- 
+
+## Validation
+
+Commands and checks run:
+
+```bash
+make release-smoke
+```
+
+Additional targeted validation:
+
+- 
+
+## Risk and compatibility
+
+- Breaking changes:
+- Migration required:
+- Performance impact:
+- Security impact:
+
+## Checklist
+
+- [ ] Tests or evals added or updated for behavior changes
+- [ ] Docs updated if user-facing behavior changed
+- [ ] No unrelated changes included
+- [ ] Ready for review

cellin-0.1.1/.github/release.yml

@@ -0,0 +1,26 @@
+changelog:
+  categories:
+    - title: Features
+      labels:
+        - enhancement
+        - multimodal
+        - retrieval
+        - dreaming
+        - evals
+        - plugin
+    - title: Architecture and Rigor
+      labels:
+        - architecture
+        - rigor-uplift
+    - title: Documentation
+      labels:
+        - documentation
+    - title: Fixes
+      labels:
+        - bug
+  exclude:
+    labels:
+      - question
+      - duplicate
+      - invalid
+      - wontfix

cellin-0.1.1/.github/rulesets/default-branch-release-grade.json

@@ -0,0 +1,44 @@
+{
+  "name": "default-branch-release-grade",
+  "target": "branch",
+  "enforcement": "active",
+  "conditions": {
+    "ref_name": {
+      "include": ["~DEFAULT_BRANCH"],
+      "exclude": []
+    }
+  },
+  "rules": [
+    {
+      "type": "deletion"
+    },
+    {
+      "type": "non_fast_forward"
+    },
+    {
+      "type": "pull_request",
+      "parameters": {
+        "allowed_merge_methods": ["merge", "squash", "rebase"],
+        "dismiss_stale_reviews_on_push": true,
+        "require_code_owner_review": true,
+        "require_last_push_approval": true,
+        "required_approving_review_count": 1,
+        "required_review_thread_resolution": true
+      }
+    },
+    {
+      "type": "required_status_checks",
+      "parameters": {
+        "strict_required_status_checks_policy": true,
+        "required_status_checks": [
+          {
+            "context": "verify"
+          },
+          {
+            "context": "package-smoke"
+          }
+        ]
+      }
+    }
+  ]
+}

cellin-0.1.1/.github/workflows/release-please.yml

@@ -0,0 +1,36 @@
+name: release-please
+
+"on":
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+concurrency:
+  group: release-please-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    env:
+      RELEASE_PLEASE_TOKEN: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+    steps:
+      - name: Report missing token
+        if: ${{ env.RELEASE_PLEASE_TOKEN == '' }}
+        run: |
+          echo "::warning::RELEASE_PLEASE_TOKEN is not configured. Stable release initiation remains disabled until the token is added."
+
+      - name: Run release-please
+        if: ${{ env.RELEASE_PLEASE_TOKEN != '' }}
+        uses: googleapis/release-please-action@v4
+        with:
+          token: ${{ env.RELEASE_PLEASE_TOKEN }}
+          target-branch: main
+          config-file: release-please-config.json
+          manifest-file: .release-please-manifest.json