Fact Intake Runner

Name: Fact Intake Runner
Author: lulufoo

ASecurity

Compose fact-intake orchestrator: intake document to classified focus-slice facts.

3 stars
0 votes
0 copies
0 views
Added October 2, 2026

ai-agentspythonbash

Security analysis

A100/100

Pro scans all 6 files and shows the line behind each finding

Scanned October 5, 2026

npx -y skills add lulufoo/lulu-workflow --skill fact-intake-runner --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Fact Intake Runner?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Fact Intake Runner

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/lulufoo-fact-intake-runner/badge)](https://www.skillsdirectory.com/skills/lulufoo-fact-intake-runner)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: fact-intake-runner
description: >-
  Compose fact-intake orchestrator: intake document to classified
  focus-slice facts.
---

# fact-intake-runner

Turn `$SOURCE_PATH` into classified focus-slice facts. Done when Confirm
apply exits 0.

**Must:** bind Parent Inputs; dispatch L1; `$FACTS_CTL validate
--require-derivation`; inline Confirm.  
**Must not:** Derive / Shape / G2 / G3 / `fact-store-runner`; edit
`$SOURCE_PATH`; fetch registry/role in parent Load.

## Parent-Provided Inputs

| Variable | Purpose |
|---|---|
| `$REVISION_DIR` | Absolute revision root |
| `$CYCLE_ID` | Active cycle id |
| `$SOURCE_PATH` | Absolute intake SoT doc |
| `$REQUIRE_SEED_ORIGIN` | Optional; `true` adds `--require-seed-origin` on write/validate |

Parent binds `$SOURCE_PATH` and `$REQUIRE_SEED_ORIGIN`.

## Script Macros

Contract in `--help`.

| Macro | Command |
|---|---|
| `$FACTS_CTL` | `python3 "$SKILL_ROOT/compose/scripts/facts/facts_control.py"` |
| `$FACT_INTAKE_DISPOSITION_CTL` | `python3 "$SKILL_ROOT/compose/fact-intake-runner/scripts/fact_intake_disposition_control.py"` |

## Execution

### Step 1 — Load

Bind Parent Inputs.  
**Done:** required Inputs bound → Step 2.

### Step 2 — Cut (L1 subagent)

Dispatch nested `fact-cut-runner` via `$SUBAGENT_TOOL`, then `$SUBAGENT_AWAIT_SYNC`.

```text
Load {SKILL_ROOT}/compose/fact-intake-runner/fact-cut-runner/SKILL.md and follow it.

## Input
REVISION_DIR: <$REVISION_DIR>
CYCLE_ID: <$CYCLE_ID>
SOURCE_PATH: <$SOURCE_PATH>
REQUIRE_SEED_ORIGIN: <$REQUIRE_SEED_ORIGIN>
```

### Step 3 — Validate

```bash
$FACTS_CTL validate \
  --revision-dir "$REVISION_DIR" \
  --require-derivation
# when REQUIRE_SEED_ORIGIN=true, also pass --require-seed-origin
```

Exit 0 → Step 4.

### Step 4 — Confirm

```bash
$FACT_INTAKE_DISPOSITION_CTL disposition-patch-path \
  --revision-dir "$REVISION_DIR"
```

Bind `.path` from stdout. Chat: path + counts + accept / edit / reject.

```bash
$FACT_INTAKE_DISPOSITION_CTL disposition-patch-validate \
  --revision-dir "$REVISION_DIR"
# after user accept:
$FACT_INTAKE_DISPOSITION_CTL disposition-patch-apply \
  --revision-dir "$REVISION_DIR"
```

Empty ops: user confirms explicitly. This wave: edit the patch in parent.

### Step 5 — Return

```text
Fact-intake complete.
  Source: <SOURCE_PATH>
  Facts: <abs path from validate stdout>
  Disposition: done
  Disposition-confirm: done
  Status: ok|failed
```