tarosec 0.0.0-stage → 0.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +137 -2
- package/SOURCE_NOTICES.md +14 -0
- package/package.json +17 -4
- package/skills/tarosec/LICENSE +21 -0
- package/skills/tarosec/SKILL.md +25 -0
- package/skills/tarosec/SOURCE_NOTICES.md +14 -0
- package/skills/tarosec/assets/schemas/case.schema.json +34 -0
- package/skills/tarosec/assets/schemas/engagement.schema.json +78 -0
- package/skills/tarosec/assets/schemas/evidence.schema.json +38 -0
- package/skills/tarosec/assets/schemas/exercise.schema.json +128 -0
- package/skills/tarosec/assets/schemas/finding.schema.json +46 -0
- package/skills/tarosec/references/routing.md +26 -0
- package/skills/tarosec/references/shared/authorization.md +56 -0
- package/skills/tarosec/references/shared/evidence-handling.md +43 -0
- package/skills/tarosec/references/shared/security-standards.md +34 -0
- package/skills/tarosec/scripts/route.py +38 -0
- package/skills/tarosec/scripts/validate_record.py +123 -0
- package/skills/tarosec-audit/LICENSE +21 -0
- package/skills/tarosec-audit/SKILL.md +52 -0
- package/skills/tarosec-audit/SOURCE_NOTICES.md +14 -0
- package/skills/tarosec-audit/assets/schemas/case.schema.json +34 -0
- package/skills/tarosec-audit/assets/schemas/engagement.schema.json +78 -0
- package/skills/tarosec-audit/assets/schemas/evidence.schema.json +38 -0
- package/skills/tarosec-audit/assets/schemas/exercise.schema.json +128 -0
- package/skills/tarosec-audit/assets/schemas/finding.schema.json +46 -0
- package/skills/tarosec-audit/references/agents.md +22 -0
- package/skills/tarosec-audit/references/dependencies.md +14 -0
- package/skills/tarosec-audit/references/shared/authorization.md +56 -0
- package/skills/tarosec-audit/references/shared/evidence-handling.md +43 -0
- package/skills/tarosec-audit/references/shared/security-standards.md +34 -0
- package/skills/tarosec-audit/scripts/validate_record.py +123 -0
- package/skills/tarosec-blue/LICENSE +21 -0
- package/skills/tarosec-blue/SKILL.md +56 -0
- package/skills/tarosec-blue/SOURCE_NOTICES.md +14 -0
- package/skills/tarosec-blue/assets/schemas/case.schema.json +34 -0
- package/skills/tarosec-blue/assets/schemas/engagement.schema.json +78 -0
- package/skills/tarosec-blue/assets/schemas/evidence.schema.json +38 -0
- package/skills/tarosec-blue/assets/schemas/exercise.schema.json +128 -0
- package/skills/tarosec-blue/assets/schemas/finding.schema.json +46 -0
- package/skills/tarosec-blue/references/detection-engineering.md +18 -0
- package/skills/tarosec-blue/references/shared/authorization.md +56 -0
- package/skills/tarosec-blue/references/shared/evidence-handling.md +43 -0
- package/skills/tarosec-blue/references/shared/security-standards.md +34 -0
- package/skills/tarosec-blue/scripts/validate_record.py +123 -0
- package/skills/tarosec-purple/LICENSE +21 -0
- package/skills/tarosec-purple/SKILL.md +85 -0
- package/skills/tarosec-purple/SOURCE_NOTICES.md +14 -0
- package/skills/tarosec-purple/assets/schemas/case.schema.json +34 -0
- package/skills/tarosec-purple/assets/schemas/engagement.schema.json +78 -0
- package/skills/tarosec-purple/assets/schemas/evidence.schema.json +38 -0
- package/skills/tarosec-purple/assets/schemas/exercise.schema.json +128 -0
- package/skills/tarosec-purple/assets/schemas/finding.schema.json +46 -0
- package/skills/tarosec-purple/references/exercise-design.md +36 -0
- package/skills/tarosec-purple/references/shared/authorization.md +56 -0
- package/skills/tarosec-purple/references/shared/evidence-handling.md +43 -0
- package/skills/tarosec-purple/references/shared/security-standards.md +34 -0
- package/skills/tarosec-purple/scripts/__pycache__/classify_exercise.cpython-315.pyc +0 -0
- package/skills/tarosec-purple/scripts/__pycache__/validate_record.cpython-315.pyc +0 -0
- package/skills/tarosec-purple/scripts/classify_exercise.py +170 -0
- package/skills/tarosec-purple/scripts/validate_record.py +123 -0
- package/skills/tarosec-red/LICENSE +21 -0
- package/skills/tarosec-red/SKILL.md +47 -0
- package/skills/tarosec-red/SOURCE_NOTICES.md +14 -0
- package/skills/tarosec-red/assets/schemas/case.schema.json +34 -0
- package/skills/tarosec-red/assets/schemas/engagement.schema.json +78 -0
- package/skills/tarosec-red/assets/schemas/evidence.schema.json +38 -0
- package/skills/tarosec-red/assets/schemas/exercise.schema.json +128 -0
- package/skills/tarosec-red/assets/schemas/finding.schema.json +46 -0
- package/skills/tarosec-red/references/scope.md +16 -0
- package/skills/tarosec-red/references/shared/authorization.md +56 -0
- package/skills/tarosec-red/references/shared/evidence-handling.md +43 -0
- package/skills/tarosec-red/references/shared/security-standards.md +34 -0
- package/skills/tarosec-red/scripts/validate_record.py +123 -0
- package/skills/tarosec-simulate/LICENSE +21 -0
- package/skills/tarosec-simulate/SKILL.md +32 -0
- package/skills/tarosec-simulate/SOURCE_NOTICES.md +14 -0
- package/skills/tarosec-simulate/assets/scenarios/auth.suspicious-login/events.json +22 -0
- package/skills/tarosec-simulate/assets/scenarios/auth.suspicious-login/scenario.json +16 -0
- package/skills/tarosec-simulate/assets/scenarios/endpoint.ransomware-behavior/events.json +22 -0
- package/skills/tarosec-simulate/assets/scenarios/endpoint.ransomware-behavior/scenario.json +16 -0
- package/skills/tarosec-simulate/assets/scenarios/web.attack-patterns/events.json +14 -0
- package/skills/tarosec-simulate/assets/scenarios/web.attack-patterns/scenario.json +15 -0
- package/skills/tarosec-simulate/assets/schemas/case.schema.json +34 -0
- package/skills/tarosec-simulate/assets/schemas/engagement.schema.json +78 -0
- package/skills/tarosec-simulate/assets/schemas/evidence.schema.json +38 -0
- package/skills/tarosec-simulate/assets/schemas/exercise.schema.json +128 -0
- package/skills/tarosec-simulate/assets/schemas/finding.schema.json +46 -0
- package/skills/tarosec-simulate/assets/schemas/scenario.schema.json +64 -0
- package/skills/tarosec-simulate/assets/schemas/simulation-alerts.schema.json +51 -0
- package/skills/tarosec-simulate/assets/schemas/simulation-events.schema.json +39 -0
- package/skills/tarosec-simulate/assets/schemas/simulation-result.schema.json +144 -0
- package/skills/tarosec-simulate/references/shared/authorization.md +56 -0
- package/skills/tarosec-simulate/references/shared/evidence-handling.md +43 -0
- package/skills/tarosec-simulate/references/shared/security-standards.md +34 -0
- package/skills/tarosec-simulate/references/simulation.md +29 -0
- package/skills/tarosec-simulate/scripts/classify_exercise.py +170 -0
- package/skills/tarosec-simulate/scripts/simulate.py +254 -0
- package/skills/tarosec-simulate/scripts/validate_record.py +123 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 The Refactor Room
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,138 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Tarosec
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+

|
|
4
|
+
|
|
5
|
+
**Assess. Defend. Validate. Improve.**
|
|
6
|
+
|
|
7
|
+
Tarosec is an offline cybersecurity skill suite for developers, security
|
|
8
|
+
reviewers, and detection engineers using AI coding agents. It helps agents turn
|
|
9
|
+
source code, assessment records, and telemetry into evidence-backed findings.
|
|
10
|
+
|
|
11
|
+
## Start with `$tarosec`
|
|
12
|
+
|
|
13
|
+
Install the suite using the local checkout commands below, then enter one of
|
|
14
|
+
these requests in your coding agent.
|
|
15
|
+
|
|
16
|
+
- `$tarosec ./project` starts a read-only source and configuration review.
|
|
17
|
+
- `$tarosec blue ./logs` investigates supplied telemetry.
|
|
18
|
+
- `$tarosec simulate suspicious-login` generates a synthetic fixture and report.
|
|
19
|
+
- `$tarosec verify ./case` selects Audit or Purple based on the supplied evidence.
|
|
20
|
+
- `$tarosec help` lists workflows and explains any missing specialists.
|
|
21
|
+
|
|
22
|
+
The entry point checks which specialists are installed before choosing a
|
|
23
|
+
workflow. The existing specialists remain available for direct use.
|
|
24
|
+
|
|
25
|
+
| Skill | Use it for | Modes |
|
|
26
|
+
| --- | --- | --- |
|
|
27
|
+
| [Tarosec Audit](skills/tarosec-audit/SKILL.md) | Audit source, dependencies, CI/CD, MCP and Agent Skills | `quick`, `deep`, `dependencies`, `agents`, `verify` |
|
|
28
|
+
| [Tarosec Red](skills/tarosec-red/SKILL.md) | Review scope, inventory exposed assets, and triage supplied assessment results | `recon`, `scan`, `simulate`, `bounty`, `validate` |
|
|
29
|
+
| [Tarosec Blue](skills/tarosec-blue/SKILL.md) | Investigate supplied telemetry and design or verify detection logic | `hunt`, `triage`, `logs`, `detect`, `verify`, `monitor` |
|
|
30
|
+
| [Tarosec Purple](skills/tarosec-purple/SKILL.md) | Compare recorded exercise steps with expected telemetry and alerts | `plan`, `exercise`, `emulate`, `validate`, `coverage`, `retest` |
|
|
31
|
+
| [Tarosec Simulate](skills/tarosec-simulate/SKILL.md) | Generate controlled event records or replay sanitized evidence | `list`, `synthetic`, `replay` |
|
|
32
|
+
|
|
33
|
+
Use the modes as cues in an agent request. The deterministic Python helpers
|
|
34
|
+
require Python 3.10 or later.
|
|
35
|
+
|
|
36
|
+
## Install from GitHub
|
|
37
|
+
|
|
38
|
+
Install all Tarosec skills in the current project with the [Skills CLI](https://github.com/vercel-labs/skills):
|
|
39
|
+
|
|
40
|
+
```bash
|
|
41
|
+
npx skills add refactorroom/tarosec
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Select individual skills or install for specific agents:
|
|
45
|
+
|
|
46
|
+
```bash
|
|
47
|
+
npx skills add refactorroom/tarosec --skill tarosec --skill tarosec-simulate
|
|
48
|
+
npx skills add refactorroom/tarosec --skill tarosec-audit --agent codex claude-code
|
|
49
|
+
npx skills add refactorroom/tarosec --list
|
|
50
|
+
npx skills list
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
Add `--global` when installing for your user account. After installation, start
|
|
54
|
+
a new agent session and request `$tarosec ./project` or `$tarosec simulate suspicious-login`.
|
|
55
|
+
The [Skills directory](https://skills.sh/docs/faq) discovers public skills from
|
|
56
|
+
installation activity.
|
|
57
|
+
|
|
58
|
+
## Install from a local checkout
|
|
59
|
+
|
|
60
|
+
Run from the project where you want to use Tarosec. Replace the source path with
|
|
61
|
+
the absolute path to this checkout.
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx skills@1.9.0 add /path/to/tarosec --list
|
|
65
|
+
npx skills@1.9.0 add /path/to/tarosec --skill '*' --agent codex claude-code --copy -y
|
|
66
|
+
npx skills@1.9.0 list --agent codex claude-code
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Select a single skill with `--skill tarosec-purple`, or choose one agent with
|
|
70
|
+
`--agent codex` or `--agent claude-code`. These project-level commands were
|
|
71
|
+
checked locally with Vercel Skills 1.9.0. For a session-only Claude Code plugin,
|
|
72
|
+
use `claude --plugin-dir /path/to/tarosec`. See [installation and troubleshooting](docs/install.md).
|
|
73
|
+
|
|
74
|
+
## Try it offline
|
|
75
|
+
|
|
76
|
+
Run the helper from this checkout to reproduce the suspicious login demo. Choose
|
|
77
|
+
a fresh directory for `./login-report`.
|
|
78
|
+
|
|
79
|
+
```bash
|
|
80
|
+
python3 -B skills/tarosec-simulate/scripts/simulate.py synthetic suspicious-login --output ./login-report
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
The captured run generated five events and returned **Inconclusive** because it
|
|
84
|
+
had no independent rule observations. The [run report](examples/simulation/suspicious-login/report.md)
|
|
85
|
+
links the assessment to hashed evidence. See the [catalog and replay guide](docs/simulation.md).
|
|
86
|
+
|
|
87
|
+
Open this checkout with the desired skill installed, then give the agent one
|
|
88
|
+
of these requests. Fixture inputs are under [evaluations](evaluations/fixtures).
|
|
89
|
+
|
|
90
|
+
- **Audit** — Review `evaluations/fixtures/A1-audit-green-idor/app/invoices.py`
|
|
91
|
+
and the tests beside it. Check invoice read and refund authorization against
|
|
92
|
+
the policy in the fixture's `TASK.md`. Cite the effective guard and coverage gaps.
|
|
93
|
+
- **Red** — Review `evaluations/fixtures/R1-red-scope/engagement.json` and
|
|
94
|
+
`recon-notes.md`. List supplied assets and separate in-scope, excluded and
|
|
95
|
+
unverified entries. Keep the assessment offline.
|
|
96
|
+
- **Blue** — Triage `evaluations/fixtures/B2-blue-false-positive/events.jsonl`.
|
|
97
|
+
Correlate the alert with the change approval and job run. State which evidence
|
|
98
|
+
would change your conclusion.
|
|
99
|
+
- **Purple** — Compare `examples/exercise.example.json` and
|
|
100
|
+
`examples/exercise.retest.json`. Report the outcome for S1 and cite the evidence IDs.
|
|
101
|
+
|
|
102
|
+
The standalone Purple helper applies the same outcome table:
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
python3 -B skills/tarosec-purple/scripts/classify_exercise.py examples/exercise.example.json --json
|
|
106
|
+
python3 -B skills/tarosec-purple/scripts/classify_exercise.py examples/exercise.retest.json --json
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
The supplied event initially has a **Detection gap**. The retest records
|
|
110
|
+
**Detected** with a 12-second delay. Both runs use synthetic records. See the
|
|
111
|
+
[worked example](examples/README.md) for the evidence chain and inconclusive case.
|
|
112
|
+
|
|
113
|
+
## Boundaries and limitations
|
|
114
|
+
|
|
115
|
+
Tarosec v0.1 works from supplied artifacts and benign synthetic data. It
|
|
116
|
+
supports offline asset inventory, scan-report review, defensive investigations,
|
|
117
|
+
and detection exercises. Active scans, exploitation, live emulation, and
|
|
118
|
+
production execution are outside the release scope.
|
|
119
|
+
|
|
120
|
+
An engagement record documents scope. Authority comes from the operator.
|
|
121
|
+
Skill guidance depends on the host for tool, filesystem and network restrictions.
|
|
122
|
+
Use the [authorization rules](references/authorization.md) and
|
|
123
|
+
[evidence-handling guidance](references/evidence-handling.md) when reviewing private data.
|
|
124
|
+
|
|
125
|
+
## Development
|
|
126
|
+
|
|
127
|
+
```bash
|
|
128
|
+
python3 -B scripts/sync_shared.py --check
|
|
129
|
+
python3 -B -m unittest discover -s tests -v
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
Each directory under `skills/` bundles its instructions, references, schemas,
|
|
133
|
+
validator and license notices. Edit shared files at the repository root and run
|
|
134
|
+
`python3 -B scripts/sync_shared.py`. See the [architecture and roadmap](docs/design.md),
|
|
135
|
+
[migration assessment](docs/migration.md), [evaluation instructions](evaluations/README.md),
|
|
136
|
+
[release readiness](docs/release-readiness.md), and [contribution guide](CONTRIBUTING.md).
|
|
137
|
+
|
|
138
|
+
[MIT license](LICENSE) · [Source notices](SOURCE_NOTICES.md) · [Security policy](SECURITY.md)
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Source notices
|
|
2
|
+
|
|
3
|
+
Tarosec uses the MIT license. The copyright notice and terms are in [LICENSE](LICENSE).
|
|
4
|
+
|
|
5
|
+
Some audit, scope review, evidence handling, defensive investigation and exercise
|
|
6
|
+
design guidance adapts concepts from Panda Suite's `panda-security` and former
|
|
7
|
+
`panda-recon` skills. Panda Suite 1.9.0 distributes the successor security skills
|
|
8
|
+
under its MIT terms. The Panda Suite copyright notice is **Copyright (c) 2026
|
|
9
|
+
akkaraponph**. The upstream license has the same MIT terms as the bundled
|
|
10
|
+
license. [Panda Suite license at the inspected revision](https://github.com/refactorroom/panda-suite/blob/8c4aae1ee1b4a978957a8421b2b797bb7add3c0c/LICENSE)
|
|
11
|
+
|
|
12
|
+
Tarosec's JSON records, validation and classification helpers, fixture inputs,
|
|
13
|
+
and evaluation harness were authored for Tarosec. The standards and tool links
|
|
14
|
+
identify external references. Their content is not bundled.
|
package/package.json
CHANGED
|
@@ -1,6 +1,19 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "tarosec",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Offline cybersecurity skills for audit, investigation, and detection validation",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "git+https://github.com/refactorroom/tarosec.git"
|
|
9
|
+
},
|
|
10
|
+
"homepage": "https://refactorroom.github.io/tarosec/",
|
|
11
|
+
"bugs": {
|
|
12
|
+
"url": "https://github.com/refactorroom/tarosec/issues"
|
|
13
|
+
},
|
|
14
|
+
"keywords": ["agent-skills", "security", "cybersecurity", "detection", "audit"],
|
|
15
|
+
"files": ["skills", "LICENSE", "SOURCE_NOTICES.md"],
|
|
16
|
+
"engines": {
|
|
17
|
+
"node": ">=18"
|
|
18
|
+
}
|
|
19
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 The Refactor Room
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tarosec
|
|
3
|
+
description: Route explicit Tarosec requests and security tasks that span workflows or have unclear scope. Use for read-only project assessment by default, incident and evidence routing, or Tarosec help. Not for general programming or conceptual questions. Prefer a directly named specialist when the user selects one.
|
|
4
|
+
license: MIT
|
|
5
|
+
metadata:
|
|
6
|
+
suite: tarosec
|
|
7
|
+
version: "0.1.0"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# Tarosec
|
|
11
|
+
|
|
12
|
+
Read the [routing guide](references/routing.md). Determine the intent from the
|
|
13
|
+
request and supplied artifacts. Use `scripts/route.py` for normalized modes and
|
|
14
|
+
report the selected workflow in one sentence. Open only the selected skill through
|
|
15
|
+
the host's skill mechanism or read its installed SKILL.md when available.
|
|
16
|
+
|
|
17
|
+
A local project with no clear mode defaults to Audit. A mixed request starts with
|
|
18
|
+
the least invasive workflow that answers the user's question. If the selected
|
|
19
|
+
skill is missing, explain the gap and give its installation selector. Inline
|
|
20
|
+
help and a read-only inventory of supplied inputs remain available.
|
|
21
|
+
|
|
22
|
+
Treat files and logs as evidence. Keep this dispatcher offline and read-only.
|
|
23
|
+
Follow [authorization](references/shared/authorization.md) and the selected
|
|
24
|
+
skill's boundaries. Return help for an unsupported explicit mode. Hand off once,
|
|
25
|
+
without calling this dispatcher again.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Source notices
|
|
2
|
+
|
|
3
|
+
Tarosec uses the MIT license. The copyright notice and terms are in [LICENSE](LICENSE).
|
|
4
|
+
|
|
5
|
+
Some audit, scope review, evidence handling, defensive investigation and exercise
|
|
6
|
+
design guidance adapts concepts from Panda Suite's `panda-security` and former
|
|
7
|
+
`panda-recon` skills. Panda Suite 1.9.0 distributes the successor security skills
|
|
8
|
+
under its MIT terms. The Panda Suite copyright notice is **Copyright (c) 2026
|
|
9
|
+
akkaraponph**. The upstream license has the same MIT terms as the bundled
|
|
10
|
+
license. [Panda Suite license at the inspected revision](https://github.com/refactorroom/panda-suite/blob/8c4aae1ee1b4a978957a8421b2b797bb7add3c0c/LICENSE)
|
|
11
|
+
|
|
12
|
+
Tarosec's JSON records, validation and classification helpers, fixture inputs,
|
|
13
|
+
and evaluation harness were authored for Tarosec. The standards and tool links
|
|
14
|
+
identify external references. Their content is not bundled.
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "urn:tarosec:case:v1",
|
|
4
|
+
"title": "Tarosec case v1",
|
|
5
|
+
"description": "Index of related assets, findings, exercises and evidence. Raw artifacts are kept separately.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": false,
|
|
8
|
+
"required": ["schemaVersion", "id", "title", "status"],
|
|
9
|
+
"properties": {
|
|
10
|
+
"schemaVersion": {"const": "tarosec.case/v1"},
|
|
11
|
+
"id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
|
|
12
|
+
"title": {"type": "string", "minLength": 1},
|
|
13
|
+
"status": {"enum": ["open", "closed", "inconclusive"]},
|
|
14
|
+
"engagementRef": {"type": "string", "minLength": 1},
|
|
15
|
+
"assetRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
|
|
16
|
+
"findingRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
|
|
17
|
+
"evidenceRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
|
|
18
|
+
"exerciseRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
|
|
19
|
+
"legacyId": {"type": "string", "minLength": 1},
|
|
20
|
+
"activities": {
|
|
21
|
+
"type": "array",
|
|
22
|
+
"items": {
|
|
23
|
+
"type": "object",
|
|
24
|
+
"additionalProperties": false,
|
|
25
|
+
"required": ["at", "description"],
|
|
26
|
+
"properties": {
|
|
27
|
+
"at": {"type": "string", "minLength": 1},
|
|
28
|
+
"description": {"type": "string", "minLength": 1},
|
|
29
|
+
"evidenceRefs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}}
|
|
30
|
+
}
|
|
31
|
+
}
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
}
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "urn:tarosec:engagement:v1",
|
|
4
|
+
"title": "Tarosec engagement v1",
|
|
5
|
+
"description": "Describes permitted targets and techniques. It narrows scope; it is never authorization by itself.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": false,
|
|
8
|
+
"required": ["schemaVersion", "id", "name", "environment", "authorization", "scope", "techniques", "window", "budgets", "stopConditions"],
|
|
9
|
+
"properties": {
|
|
10
|
+
"schemaVersion": {"const": "tarosec.engagement/v1"},
|
|
11
|
+
"id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
|
|
12
|
+
"name": {"type": "string", "minLength": 1},
|
|
13
|
+
"environment": {"enum": ["offline", "laboratory", "staging", "production"]},
|
|
14
|
+
"authorization": {
|
|
15
|
+
"type": "object",
|
|
16
|
+
"additionalProperties": false,
|
|
17
|
+
"required": ["reference", "authorizedBy", "note"],
|
|
18
|
+
"properties": {
|
|
19
|
+
"reference": {"type": "string", "minLength": 1},
|
|
20
|
+
"authorizedBy": {"type": "string", "minLength": 1},
|
|
21
|
+
"note": {"type": "string", "minLength": 1}
|
|
22
|
+
}
|
|
23
|
+
},
|
|
24
|
+
"scope": {
|
|
25
|
+
"type": "object",
|
|
26
|
+
"additionalProperties": false,
|
|
27
|
+
"required": ["targets", "exclusions"],
|
|
28
|
+
"properties": {
|
|
29
|
+
"targets": {
|
|
30
|
+
"type": "array",
|
|
31
|
+
"minItems": 1,
|
|
32
|
+
"items": {
|
|
33
|
+
"type": "object",
|
|
34
|
+
"additionalProperties": false,
|
|
35
|
+
"required": ["id", "kind", "value"],
|
|
36
|
+
"properties": {
|
|
37
|
+
"id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
|
|
38
|
+
"kind": {"enum": ["origin", "url-prefix", "host", "ip", "cidr", "repository", "path", "lab-host"]},
|
|
39
|
+
"value": {"type": "string", "minLength": 1},
|
|
40
|
+
"allowedAddresses": {"type": "array", "items": {"type": "string", "minLength": 1}}
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
},
|
|
44
|
+
"exclusions": {"type": "array", "items": {"type": "string", "minLength": 1}}
|
|
45
|
+
}
|
|
46
|
+
},
|
|
47
|
+
"techniques": {
|
|
48
|
+
"type": "object",
|
|
49
|
+
"additionalProperties": false,
|
|
50
|
+
"required": ["allowed", "forbidden"],
|
|
51
|
+
"properties": {
|
|
52
|
+
"allowed": {"type": "array", "items": {"type": "string", "minLength": 1}},
|
|
53
|
+
"forbidden": {"type": "array", "items": {"type": "string", "minLength": 1}}
|
|
54
|
+
}
|
|
55
|
+
},
|
|
56
|
+
"window": {
|
|
57
|
+
"type": "object",
|
|
58
|
+
"additionalProperties": false,
|
|
59
|
+
"required": ["start", "end", "timezone"],
|
|
60
|
+
"properties": {
|
|
61
|
+
"start": {"type": "string", "minLength": 1},
|
|
62
|
+
"end": {"type": "string", "minLength": 1},
|
|
63
|
+
"timezone": {"type": "string", "minLength": 1}
|
|
64
|
+
}
|
|
65
|
+
},
|
|
66
|
+
"budgets": {
|
|
67
|
+
"type": "object",
|
|
68
|
+
"additionalProperties": false,
|
|
69
|
+
"properties": {
|
|
70
|
+
"maxRequestsPerSecond": {"type": "number", "minimum": 0},
|
|
71
|
+
"maxTotalRequests": {"type": "integer", "minimum": 0},
|
|
72
|
+
"maxDurationMinutes": {"type": "integer", "minimum": 0}
|
|
73
|
+
}
|
|
74
|
+
},
|
|
75
|
+
"stopConditions": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
|
|
76
|
+
"evidenceHandling": {"type": "string", "minLength": 1}
|
|
77
|
+
}
|
|
78
|
+
}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "urn:tarosec:evidence:v1",
|
|
4
|
+
"title": "Tarosec evidence v1",
|
|
5
|
+
"type": "object",
|
|
6
|
+
"additionalProperties": false,
|
|
7
|
+
"required": ["schemaVersion", "id", "source", "collectionMethod", "collectedAt", "originalTimezone", "sensitivity", "integrity"],
|
|
8
|
+
"properties": {
|
|
9
|
+
"schemaVersion": {"const": "tarosec.evidence/v1"},
|
|
10
|
+
"id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
|
|
11
|
+
"source": {"type": "string", "minLength": 1},
|
|
12
|
+
"collectionMethod": {"type": "string", "minLength": 1},
|
|
13
|
+
"collectedBy": {"type": "string"},
|
|
14
|
+
"collectedAt": {"type": "string", "minLength": 1},
|
|
15
|
+
"originalTimezone": {"type": "string", "minLength": 1, "description": "IANA zone, UTC offset, or 'unknown'."},
|
|
16
|
+
"artifactPath": {"type": "string"},
|
|
17
|
+
"sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
|
|
18
|
+
"sensitivity": {"enum": ["public", "internal", "confidential", "restricted"]},
|
|
19
|
+
"redacted": {"type": "boolean"},
|
|
20
|
+
"integrity": {"enum": ["verified-against-reference", "hash-recorded", "mismatch", "no-artifact", "unknown"]},
|
|
21
|
+
"limitations": {"type": "string"},
|
|
22
|
+
"relatedFindings": {"type": "array", "items": {"type": "string"}},
|
|
23
|
+
"relatedExercises": {"type": "array", "items": {"type": "string", "minLength": 1}},
|
|
24
|
+
"custody": {
|
|
25
|
+
"type": "array",
|
|
26
|
+
"items": {
|
|
27
|
+
"type": "object",
|
|
28
|
+
"additionalProperties": false,
|
|
29
|
+
"required": ["at", "actor", "action"],
|
|
30
|
+
"properties": {
|
|
31
|
+
"at": {"type": "string", "minLength": 1},
|
|
32
|
+
"actor": {"type": "string", "minLength": 1},
|
|
33
|
+
"action": {"type": "string", "minLength": 1}
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "urn:tarosec:exercise:v1",
|
|
4
|
+
"title": "Tarosec purple exercise v1",
|
|
5
|
+
"description": "Expected defensive observations per emulation step, plus optional recorded results. Never authorization by itself.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": false,
|
|
8
|
+
"required": ["schemaVersion", "id", "name", "environment", "attackVersion", "window", "steps"],
|
|
9
|
+
"properties": {
|
|
10
|
+
"schemaVersion": {"const": "tarosec.exercise/v1"},
|
|
11
|
+
"id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
|
|
12
|
+
"name": {"type": "string", "minLength": 1},
|
|
13
|
+
"objective": {"type": "string", "minLength": 1},
|
|
14
|
+
"retestOf": {"type": "string", "minLength": 1},
|
|
15
|
+
"changeSummary": {"type": "string", "minLength": 1},
|
|
16
|
+
"limitations": {"type": "array", "items": {"type": "string", "minLength": 1}},
|
|
17
|
+
"engagementRef": {"type": "string"},
|
|
18
|
+
"environment": {"enum": ["offline", "laboratory", "staging", "production"]},
|
|
19
|
+
"attackVersion": {"type": "string", "minLength": 1},
|
|
20
|
+
"window": {
|
|
21
|
+
"type": "object",
|
|
22
|
+
"additionalProperties": false,
|
|
23
|
+
"required": ["start", "end"],
|
|
24
|
+
"properties": {
|
|
25
|
+
"start": {"type": "string", "minLength": 1},
|
|
26
|
+
"end": {"type": "string", "minLength": 1}
|
|
27
|
+
}
|
|
28
|
+
},
|
|
29
|
+
"steps": {
|
|
30
|
+
"type": "array",
|
|
31
|
+
"minItems": 1,
|
|
32
|
+
"items": {
|
|
33
|
+
"type": "object",
|
|
34
|
+
"additionalProperties": false,
|
|
35
|
+
"required": ["id", "description", "targetHost", "expected"],
|
|
36
|
+
"properties": {
|
|
37
|
+
"id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
|
|
38
|
+
"technique": {
|
|
39
|
+
"type": "object",
|
|
40
|
+
"additionalProperties": false,
|
|
41
|
+
"required": ["id", "name"],
|
|
42
|
+
"properties": {
|
|
43
|
+
"id": {"type": "string", "pattern": "^T[0-9]{4}(\\.[0-9]{3})?$"},
|
|
44
|
+
"name": {"type": "string", "minLength": 1}
|
|
45
|
+
}
|
|
46
|
+
},
|
|
47
|
+
"description": {"type": "string", "minLength": 1},
|
|
48
|
+
"targetHost": {"type": "string", "minLength": 1},
|
|
49
|
+
"countermeasures": {
|
|
50
|
+
"type": "array",
|
|
51
|
+
"items": {
|
|
52
|
+
"type": "object",
|
|
53
|
+
"additionalProperties": false,
|
|
54
|
+
"required": ["id", "name"],
|
|
55
|
+
"properties": {
|
|
56
|
+
"id": {"type": "string", "pattern": "^D3-[A-Z0-9]+$"},
|
|
57
|
+
"name": {"type": "string", "minLength": 1}
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
},
|
|
61
|
+
"expected": {
|
|
62
|
+
"type": "object",
|
|
63
|
+
"additionalProperties": false,
|
|
64
|
+
"required": ["telemetrySources", "detections", "maxLatencySeconds"],
|
|
65
|
+
"properties": {
|
|
66
|
+
"telemetrySources": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
|
|
67
|
+
"detections": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
|
|
68
|
+
"requireTelemetryForDetection": {"type": "boolean"},
|
|
69
|
+
"maxLatencySeconds": {"type": "integer", "minimum": 0}
|
|
70
|
+
}
|
|
71
|
+
},
|
|
72
|
+
"results": {
|
|
73
|
+
"type": "object",
|
|
74
|
+
"additionalProperties": false,
|
|
75
|
+
"required": ["execution"],
|
|
76
|
+
"properties": {
|
|
77
|
+
"execution": {
|
|
78
|
+
"type": "object",
|
|
79
|
+
"additionalProperties": false,
|
|
80
|
+
"required": ["status"],
|
|
81
|
+
"properties": {
|
|
82
|
+
"status": {"enum": ["executed", "failed", "blocked", "not_run", "unknown"]},
|
|
83
|
+
"startedAt": {"type": "string"},
|
|
84
|
+
"endedAt": {"type": "string"},
|
|
85
|
+
"prevented": {"type": "boolean"},
|
|
86
|
+
"evidenceRefs": {"type": "array", "items": {"type": "string"}}
|
|
87
|
+
}
|
|
88
|
+
},
|
|
89
|
+
"reportedOutcome": {
|
|
90
|
+
"description": "Optional analyst annotation. The classifier derives its outcome from the observations.",
|
|
91
|
+
"enum": ["Detected", "Detected (late)", "Partially detected", "Prevented", "Detection gap", "Telemetry gap", "Inconclusive", "Not run"]
|
|
92
|
+
},
|
|
93
|
+
"telemetry": {
|
|
94
|
+
"type": "array",
|
|
95
|
+
"items": {
|
|
96
|
+
"type": "object",
|
|
97
|
+
"additionalProperties": false,
|
|
98
|
+
"required": ["source", "status"],
|
|
99
|
+
"properties": {
|
|
100
|
+
"source": {"type": "string", "minLength": 1},
|
|
101
|
+
"status": {"enum": ["observed", "absent", "unknown"]},
|
|
102
|
+
"sourceHealthy": {"type": "boolean"},
|
|
103
|
+
"evidenceRefs": {"type": "array", "items": {"type": "string"}}
|
|
104
|
+
}
|
|
105
|
+
}
|
|
106
|
+
},
|
|
107
|
+
"alerts": {
|
|
108
|
+
"type": "array",
|
|
109
|
+
"items": {
|
|
110
|
+
"type": "object",
|
|
111
|
+
"additionalProperties": false,
|
|
112
|
+
"required": ["ruleId", "status"],
|
|
113
|
+
"properties": {
|
|
114
|
+
"ruleId": {"type": "string", "minLength": 1},
|
|
115
|
+
"status": {"enum": ["fired", "not_fired", "unknown"]},
|
|
116
|
+
"firedAt": {"type": "string"},
|
|
117
|
+
"host": {"type": "string"},
|
|
118
|
+
"evidenceRefs": {"type": "array", "items": {"type": "string"}}
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
}
|
|
123
|
+
}
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
}
|
|
128
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
3
|
+
"$id": "urn:tarosec:finding:v1",
|
|
4
|
+
"title": "Tarosec finding v1",
|
|
5
|
+
"description": "Shared by audit, red, blue and purple. Severity, confidence and status are independent axes.",
|
|
6
|
+
"type": "object",
|
|
7
|
+
"additionalProperties": false,
|
|
8
|
+
"required": ["schemaVersion", "id", "producer", "title", "severity", "severityRationale", "confidence", "status", "claimStrength", "location", "invariant", "observed", "impact", "evidenceRefs", "remediation", "regressionCheck"],
|
|
9
|
+
"properties": {
|
|
10
|
+
"schemaVersion": {"const": "tarosec.finding/v1"},
|
|
11
|
+
"id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"},
|
|
12
|
+
"producer": {"enum": ["tarosec-audit", "tarosec-red", "tarosec-blue", "tarosec-purple"]},
|
|
13
|
+
"title": {"type": "string", "minLength": 1},
|
|
14
|
+
"description": {"type": "string", "minLength": 1},
|
|
15
|
+
"createdAt": {"type": "string", "minLength": 1},
|
|
16
|
+
"updatedAt": {"type": "string", "minLength": 1},
|
|
17
|
+
"severity": {"enum": ["Critical", "High", "Medium", "Low", "Informational"]},
|
|
18
|
+
"severityRationale": {"type": "string", "minLength": 1},
|
|
19
|
+
"confidence": {"enum": ["Confirmed", "Likely", "Unknown"]},
|
|
20
|
+
"status": {"enum": ["Potential weakness", "Verified vulnerability", "Simulation observation", "Detection gap", "Telemetry gap", "Informational", "False positive"]},
|
|
21
|
+
"verificationStatus": {"enum": ["unverified", "confirmed", "fixed", "inconclusive"]},
|
|
22
|
+
"claimStrength": {"enum": ["static-trace", "lab-reproduction", "observed-in-telemetry", "advisory-match", "reported-only"]},
|
|
23
|
+
"location": {"type": "string", "minLength": 1, "description": "file:line, dependency path, asset ID, or exercise step ID."},
|
|
24
|
+
"invariant": {"type": "string", "minLength": 1},
|
|
25
|
+
"observed": {"type": "string", "minLength": 1},
|
|
26
|
+
"impact": {"type": "string", "minLength": 1},
|
|
27
|
+
"preconditions": {"type": "string"},
|
|
28
|
+
"evidenceRefs": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
|
|
29
|
+
"remediation": {"type": "string", "minLength": 1},
|
|
30
|
+
"regressionCheck": {"type": "string", "minLength": 1},
|
|
31
|
+
"mappings": {
|
|
32
|
+
"type": "array",
|
|
33
|
+
"items": {
|
|
34
|
+
"type": "object",
|
|
35
|
+
"additionalProperties": false,
|
|
36
|
+
"required": ["framework", "version", "id"],
|
|
37
|
+
"properties": {
|
|
38
|
+
"framework": {"enum": ["CWE", "OWASP-ASVS", "OWASP-Top10", "ATTACK", "D3FEND"]},
|
|
39
|
+
"version": {"type": "string", "minLength": 1},
|
|
40
|
+
"id": {"type": "string", "minLength": 1},
|
|
41
|
+
"name": {"type": "string"}
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
# Routing
|
|
2
|
+
|
|
3
|
+
| Mode or intent | Skill and use |
|
|
4
|
+
| --- | --- |
|
|
5
|
+
| Project path, scan, audit, source or configuration review | Audit, read-only |
|
|
6
|
+
| Red, attack surface review | Red, supplied records only |
|
|
7
|
+
| Blue, logs, hunting, or incident | Blue for offline triage |
|
|
8
|
+
| Purple or detection validation | Purple for recorded observations |
|
|
9
|
+
| Simulate, generate events, or replay | Simulate for offline fixtures |
|
|
10
|
+
| Verify | Audit for a source fix, Purple for detection retest |
|
|
11
|
+
| Intel | Audit for supplied advisory review |
|
|
12
|
+
| Report | Summarize supplied records with their evidence IDs and limits |
|
|
13
|
+
| Help | Explain the modes and available skills |
|
|
14
|
+
|
|
15
|
+
The routing helper accepts a normalized mode. To route natural language, inspect
|
|
16
|
+
the requested action and artifact first. For ambiguous verification, use Audit
|
|
17
|
+
unless the evidence describes a defensive exercise. Use `--evidence exercise`
|
|
18
|
+
for that case. Report when source artifacts are missing. Current intelligence
|
|
19
|
+
requires an authorized source lookup and is outside the offline fallback.
|
|
20
|
+
|
|
21
|
+
Pass the names of specialists that the host exposes to this session as repeated
|
|
22
|
+
`--available` flags. Run `python3 scripts/route.py help` for the contract.
|
|
23
|
+
An installed specialist owns the work. For a missing specialist, use the
|
|
24
|
+
`installSelector` in the response with the project's Skills CLI source.
|
|
25
|
+
An entry-only install can provide a read-only inventory of supplied artifacts,
|
|
26
|
+
cite existing records, and help the user choose a workflow.
|