sf-smartfeed 3.0.0__py3-none-any.whl

sf_smartfeed/__init__.py

@@ -0,0 +1,2 @@
+"""SmartFeed — Distill the firehose. A tight brief of only what moves your work."""
+from ._version import __version__

sf_smartfeed/__main__.py

@@ -0,0 +1,3 @@
+from .cli import main
+import sys
+sys.exit(main())

sf_smartfeed/_version.py

@@ -0,0 +1 @@
+__version__ = "3.0.0"

sf_smartfeed/cli.py

@@ -0,0 +1,35 @@
+"""SmartFeed CLI — run `sf-smartfeed --demo`."""
+import os, sys, json
+from . import core
+from ._version import __version__
+
+
+def _demo_dir():
+    return os.path.join(os.path.dirname(__file__), "..", "..", "demo")
+
+
+def main(argv=None):
+    argv = argv if argv is not None else sys.argv[1:]
+    if "--version" in argv:
+        print(f"SmartFeed {__version__}"); return 0
+    demo = "--demo" in argv or not argv
+    print(f"\n🦔 SmartFeed {__version__}  ·  IAIso §9 · Awareness")
+    result = core_demo()
+    print(result)
+    print(f"\nBacked by IAIso §9 · Awareness · part of the Smart* family · https://smarttasks.cloud\n")
+    return 0
+
+
+def core_demo() -> str:
+    return _DEMO()
+
+
+def _DEMO():
+    b = core.distill()
+    out = [f"distilled brief (dedup {int(b.dedup_ratio*100)}%):"]
+    for s in b.items:
+        out.append(f"  • [{s.source}] score {s.score} (v{s.velocity})")
+    return "\n".join(out)
+
+if __name__ == "__main__":
+    sys.exit(main())

sf_smartfeed/core.py

@@ -0,0 +1,19 @@
+"""SmartFeed core — distill the firehose into a brief."""
+import json, os
+from .models import Signal, Brief
+
+def _stream():
+    return [Signal("hn", 88, 9.1), Signal("hn", 86, 8.8), Signal("reddit", 62, 4.2),
+            Signal("gtrends", 70, 6.0), Signal("reddit", 61, 4.0), Signal("arxiv", 55, 3.1),
+            Signal("gtrends", 71, 6.2), Signal("news", 66, 5.0)]
+
+def distill(top: int = 5) -> Brief:
+    sigs = _stream()
+    seen, deduped = set(), []
+    for s in sorted(sigs, key=lambda x: -x.score):
+        key = (s.source, round(s.score / 5))
+        if key in seen:
+            continue
+        seen.add(key); deduped.append(s)
+    dedup_ratio = round(1 - len(deduped) / len(sigs), 2)
+    return Brief(deduped[:top], dedup_ratio)

sf_smartfeed/models.py

@@ -0,0 +1,14 @@
+"""UML data objects for SmartFeed — the diagram in the README is these classes."""
+from __future__ import annotations
+from dataclasses import dataclass, field
+
+@dataclass
+class Signal:
+    source: str
+    score: float
+    velocity: float
+
+@dataclass
+class Brief:
+    items: list[Signal]
+    dedup_ratio: float

sf_smartfeed-3.0.0.dist-info/METADATA

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: sf-smartfeed
+Version: 3.0.0
+Summary: Distill the firehose. A tight brief of only what moves your work.
+Author: SmartTasks Lab
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://smarttasks.cloud
+Project-URL: Source, https://github.com/SmartTasksOrg/sf-smartfeed
+Project-URL: Issues, https://github.com/SmartTasksOrg/sf-smartfeed/issues
+Project-URL: Security, https://github.com/SmartTasksOrg/sf-smartfeed/security/policy
+Project-URL: Changelog, https://github.com/SmartTasksOrg/sf-smartfeed/blob/master/CHANGELOG.md
+Project-URL: Standard, https://iaiso.org
+Keywords: smart,ai,iaiso,sf-smartfeed,devtools
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Dynamic: license-file
+
+<!-- mcp-name: io.github.smarttasksorg/sf-smartfeed -->
+<h1 align="center">🦔 SmartFeed</h1>
+<p align="center"><b>Distill the firehose. A tight brief of only what moves your work.</b></p>
+<p align="center">
+  <a href="https://iaiso.org">IAIso §9 · Awareness</a> ·
+  <a href="https://smarttasks.cloud">SmartTasks.cloud</a> ·
+  <a href="#part-of-the-smart-family">the Smart* family</a>
+</p>
+
+---
+
+## The firehose doubled; your day didn't.
+
+As AI reshapes how we work, a new gap opens: you must stay current across exploding sources; signal drowns in noise. **SmartFeed** closes it —
+`distill` at the exact moment the gap bites, and it works the second you clone it
+(a synthetic demo ships in `demo/`).
+
+## Install
+
+SmartFeed is not published on PyPI or any other package registry yet. Until
+this section says otherwise, a package called `sf-smartfeed` on any registry
+is not ours, and neither is `smartfeed`. The PyPI package `smartfeed` is a different project (Fanout); do not install it for this tool.
+
+Install from a clone (Python 3.10 or later):
+
+```bash
+git clone https://github.com/SmartTasksOrg/sf-smartfeed
+cd sf-smartfeed
+python -m venv .venv
+. .venv/bin/activate          # Windows PowerShell: .\.venv\Scripts\Activate.ps1
+python -m pip install .
+sf-smartfeed --demo
+```
+
+## Status
+
+- **Version 3.0.0, experimental.** A small deterministic command-line tool with a bundled synthetic demo and two smoke tests.
+- **Published:** nowhere yet; install from a clone (above).
+- **Tested:** the 2 smoke tests in `tests/` on Python 3.12, Linux, on every push to master and every pull request (`.github/workflows/ci.yml`).
+- **Not tested:** Windows and macOS; Python versions other than 3.12.
+- **Security review:** none independent. Report vulnerabilities as described in [SECURITY.md](SECURITY.md).
+
+## Run it in your stack
+
+| Where you work | How you run it |
+|---|---|
+| **Python** | from a clone: `python -m pip install .` (not on PyPI yet) |
+| **CI / pre-commit** | add the hook from [`.pre-commit-hooks.yaml`](.pre-commit-hooks.yaml) |
+
+## What's in this repo
+
+- **Core engine** — [`src/sf_smartfeed/`](src/sf_smartfeed/): distill() -> Brief. Deterministic, dependency-free.
+- **CLI** — `sf-smartfeed --demo` (and `--version`): a deterministic demo of the core.
+- **Also included** — a runnable [`demo/`](demo/), [`examples/`](examples/), the IAIso mapping [`spec/iaiso-map.json`](spec/iaiso-map.json), a browser [`site/playground.html`](site/playground.html), plus public smoke tests in `tests/`.
+
+## How it works
+
+Rule IDs are namespaced `FEED-*` so output looks kin to the rest of the family
+(SmartPangolin's `SEC-*`, etc.). Deterministic, dependency-free, fail-loud.
+
+### The data objects (UML)
+
+These are real dataclasses in [`src/sf_smartfeed/models.py`](src/sf_smartfeed/models.py) — the
+diagram and the code are the same thing:
+
+```mermaid
+classDiagram
+    class Signal {
+      +source: str
+      +score: float
+      +velocity: float
+    }
+    class Brief {
+      +items: list[Signal]
+      +dedup_ratio: float
+    }
+    class IAIsoControl {
+      +section: str
+      +name: str
+    }
+    Brief ..> IAIsoControl : conforms to
+```
+
+## Where it sits in the architecture
+
+SmartFeed doesn't stand alone — it stacks with the family, and everything conforms to
+the IAIso standard — the same standard that governs SmartTasks' own apps, while each tool here stays standalone and drops into your architecture:
+
+```mermaid
+graph LR
+    IAIso([IAIso standard]):::std
+    Cloud([SmartTasks.cloud]):::cloud
+    SmartPangolin[SmartPangolin]:::tool
+    SmartPrompt[SmartPrompt]:::tool
+    SmartCheck[SmartCheck]:::tool
+    SmartSeal[SmartSeal]:::tool
+    SmartStandard[SmartStandard]:::tool
+    SmartSim[SmartSim]:::tool
+    SmartMoat[SmartMoat]:::tool
+    SmartRoute[SmartRoute]:::tool
+    SmartFeed[SmartFeed]:::tool
+    SmartPangolin -->|emits clean artifacts to| SmartSeal
+    SmartPrompt -->|hands secret/PII flags to| SmartPangolin
+    SmartPrompt -->|enforces prompt rules from| SmartStandard
+    SmartCheck -->|stamps verified output with| SmartSeal
+    SmartCheck -->|checks against rules from| SmartStandard
+    SmartSeal -->|issues receipts consumed by| SmartCheck
+    SmartSeal -->|issues receipts consumed by| SmartRoute
+    SmartStandard -->|supplies rule sets to| SmartPrompt
+    SmartStandard -->|supplies rule sets to| SmartCheck
+    SmartSim -->|feeds role forecasts to| SmartMoat
+    SmartSim -->|draws signals from| SmartFeed
+    SmartMoat -->|consumes forecasts from| SmartSim
+    SmartRoute -->|verifies receipts from| SmartSeal
+    SmartRoute -->|enforces the standard from| SmartStandard
+    SmartFeed -->|feeds signals to| SmartSim
+    SmartFeed -->|feeds signals to| SmartMoat
+    SmartPangolin -.conforms.-> IAIso
+    SmartPangolin -.shares IAIso with.-> Cloud
+    SmartPrompt -.conforms.-> IAIso
+    SmartPrompt -.shares IAIso with.-> Cloud
+    SmartCheck -.conforms.-> IAIso
+    SmartCheck -.shares IAIso with.-> Cloud
+    SmartSeal -.conforms.-> IAIso
+    SmartSeal -.shares IAIso with.-> Cloud
+    SmartStandard -.conforms.-> IAIso
+    SmartStandard -.shares IAIso with.-> Cloud
+    SmartSim -.conforms.-> IAIso
+    SmartSim -.shares IAIso with.-> Cloud
+    SmartMoat -.conforms.-> IAIso
+    SmartMoat -.shares IAIso with.-> Cloud
+    SmartRoute -.conforms.-> IAIso
+    SmartRoute -.shares IAIso with.-> Cloud
+    SmartFeed -.conforms.-> IAIso
+    SmartFeed -.shares IAIso with.-> Cloud
+    IAIso -.governs.-> Cloud
+    classDef tool fill:#1c232d,stroke:#f5b83d,color:#efe9f5;
+    classDef std fill:#04121f,stroke:#46d6c8,color:#46d6c8;
+    classDef cloud fill:#1a1327,stroke:#a78bfa,color:#a78bfa;
+    style SmartFeed stroke-width:3px,stroke:#ff6b6b;
+```
+
+- **SmartFeed feeds signals to SmartSim** →
+- **SmartFeed feeds signals to SmartMoat** →
+
+Open [`site/playground.html`](site/playground.html) for the interactive version.
+
+## Part of the Smart* family
+
+One system, not nine projects — same mascot, same manifesto voice, same rule-ID style,
+all aligned to the [IAIso standard](https://github.com/SmartTasksOrg/IAIso). Each is an independent, open-source, single-purpose tool you can integrate into your own architecture:
+
+| Tool | IAIso | What it does |
+|---|---|---|
+| [SmartPangolin](https://github.com/SmartTasksOrg/sf-smartpangolin) | §1 · Secure Sharing | Scan before you share. Stop leaking secrets into AI models, agents, and tools. |
+| [SmartPrompt](https://github.com/SmartTasksOrg/sf-smartprompt) | §4 · Context | Lint before you send. Bad prompt in, bad work out — and it's your name on it. |
+| [SmartCheck](https://github.com/SmartTasksOrg/sf-smartcheck) | §2 · Verification | Check before you sign off. Catch the AI when it's confidently wrong. |
+| [SmartSeal](https://github.com/SmartTasksOrg/sf-smartseal) | §3 · Provenance | Seal what you ship. A signed receipt so anyone can verify what they received. |
+| [SmartStandard](https://github.com/SmartTasksOrg/sf-smartstandard) | §7 · Standards | Standardize before you scale. One shared, auditable convention for AI-assisted work. |
+| [SmartSim](https://github.com/SmartTasksOrg/sf-smartsim) | §8 · Foresight | Simulate before it hits you. See your role's task-by-task collapse sequence. |
+| [SmartMoat](https://github.com/SmartTasksOrg/sf-smartmoat) | §6 · Workforce | Know your moat. Score the tasks AI can't easily take — and widen them. |
+| [SmartRoute](https://github.com/SmartTasksOrg/sf-smartroute) | §5 · Orchestration | Route only what you trust. Gate agents and tools with trust scores and guardrails. |
+
+**Backed by the standard:** SmartFeed implements **IAIso §9 · Awareness**.
+**Open-source edition:** this repo is the simplified, single-purpose version, built for any org to integrate into its own architecture. SmartTasks' desktop app and [SmartTasks.cloud](https://smarttasks.cloud) run a more advanced, deeply-integrated implementation of the same IAIso governance — a separate product, not this code bundled.
+
+## Who's behind this
+
+- **Roen Branham** — CEO & AI Strategy Architect · CISSP-certified AI, security & governance architect; author of IAIso and sole inventor of the Z4 Semantic Fabric patent application. [LinkedIn](https://www.linkedin.com/in/roen-branham-167ab29/)
+- **Le Vu Tanh** — CTO & Core Engineering Lead · Chief architect of the Cortex engine; large-scale system reliability and low-latency infrastructure — the engineer who ships what gets architected. [LinkedIn](https://www.linkedin.com/in/lee-thanh-76aa8ba0/)
+
+The team behind IAIso & SmartTasks: a CISSP-certified security & governance architect
+and a large-scale systems engineer — 20+ years shipping secure, AI-driven platforms for
+regulated, blue-chip environments (Allianz, BMW, Rolls-Royce, Heidenhain).
+
+<!-- SMARTTASKS-MODELS:START -->
+## Runs on governed local models
+
+Governed local models let you run the whole family offline.
+
+This tool is local-first, so pair it with models you can actually vet. **SmartTasks** publishes 21+ governance-validated GGUF builds on Hugging Face — each with a machine-readable **scorecard** (capability tiers L1 Layman → L5 Agentic, IAIso conformance invariants (pass/warn/fail), OWASP-mapped garak red-team, transparency probes (viewpoint-alignment / over-refusal), and per-file SHA-256). Gate model selection on evidence, not vibes — and every finding, including warnings, is published in full.
+
+→ **[SmartTasks on Hugging Face](https://huggingface.co/smarttasks)** · [Qwen3.6-27B](https://huggingface.co/smarttasks/Qwen3.6-27B-GGUF) (L5 agentic) · [react-agent-coder-llama-3.1-8b](https://huggingface.co/smarttasks/react-agent-coder-llama-3.1-8b-GGUF) (agentic coder) · [gpt-oss-20b](https://huggingface.co/smarttasks/gpt-oss-20b-GGUF) (open reasoning)
+<!-- SMARTTASKS-MODELS:END -->
+
+## Get in touch
+
+- **Companies & enterprises:** [enterprise@smarttasks.cloud](mailto:enterprise@smarttasks.cloud) — we help
+  teams integrate SmartFeed + IAIso into their architecture so governance and
+  audit-readiness become a byproduct of how they already work.
+- **The standard:** [IAIso](https://github.com/SmartTasksOrg/IAIso) · [iaiso.org](https://iaiso.org)
+- **The product:** [SmartTasks.cloud](https://smarttasks.cloud)
+
+Built by **SmartTasks Lab**. Apache-2.0. Contributions welcome.

sf_smartfeed-3.0.0.dist-info/RECORD

@@ -0,0 +1,13 @@
+sf_smartfeed/__init__.py,sha256=4O4-5cDNf6JhlRxXfrBZmdCB51Ejd7PXW2OGDmKdF54,120
+sf_smartfeed/__main__.py,sha256=bOBbee4WZgJa8UKtyRPx1Gh4HnevZ65DH-FjRypS-zo,50
+sf_smartfeed/_version.py,sha256=EPmgXOdWKks5S__ZMH7Nu6xpAeVrZpfxaFy4pykuyeI,22
+sf_smartfeed/cli.py,sha256=acBwyWiWtzMbREryULzibPf1o2VCOOmJONLXXaP-sSY,969
+sf_smartfeed/core.py,sha256=-PSfYrv3tbXH87ePkKCvLMiau3Hhp2UNq5O_4a0BTyo,741
+sf_smartfeed/models.py,sha256=lFwBhH0xQwG-oST3wdHXdQCSVVLhW96Jf8z-6IsjmqE,312
+sf_smartfeed-3.0.0.dist-info/licenses/LICENSE,sha256=l-zqlRNnJz87KVVsPJSB8LAGxgSwxWBAqJ7xK4sFDTw,561
+sf_smartfeed-3.0.0.dist-info/licenses/NOTICE,sha256=NremaKCamoM6D3J2l6tZRvQxhSBeb8-ejIo8neAn08c,543
+sf_smartfeed-3.0.0.dist-info/METADATA,sha256=NtA3wNhjnMcdVi26nhOIZ45TKyOxBxGgM5ruNmwXZUA,11244
+sf_smartfeed-3.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+sf_smartfeed-3.0.0.dist-info/entry_points.txt,sha256=eQl7awSQPp_q_PpDBQ7W-SK7DvuI8-i6jdlC1yD5vZc,55
+sf_smartfeed-3.0.0.dist-info/top_level.txt,sha256=sih-KD6LtPg-T72TlcN1GG4SAo-VUPeiYwZIQhueMbE,13
+sf_smartfeed-3.0.0.dist-info/RECORD,,

sf_smartfeed-3.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

sf_smartfeed-3.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+sf-smartfeed = sf_smartfeed.cli:main

sf_smartfeed-3.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,13 @@
+Apache License 2.0
+
+Copyright 2026 SmartTasks Lab
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use
+this file except in compliance with the License. You may obtain a copy at
+
+    https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software distributed
+under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
+CONDITIONS OF ANY KIND, either express or implied. See the License for the
+specific language governing permissions and limitations under the License.

sf_smartfeed-3.0.0.dist-info/licenses/NOTICE

@@ -0,0 +1,15 @@
+SmartFeed
+Copyright 2026 SmartTasks Lab
+
+Licensed under the Apache License, Version 2.0 (see LICENSE).
+
+Names and affiliation
+---------------------
+
+SmartFeed is published by SmartTasksOrg. The only package names it is
+published under are those marked "registered": true in names.json.
+
+SmartFeed here is not Fanout's "smartfeed" package on PyPI.
+All other names are the property of their respective owners. Their use here
+only says what the software reads, evaluates or connects to; it does not
+imply affiliation, sponsorship or endorsement.

sf_smartfeed-3.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+sf_smartfeed