Stalled Notes App

This repo is reviveable, but 2 high-severity issue(s) should be handled before feature work.

Score17at-risk

Stall Hypotheses

The project likely stalled around reproducibility and validationmedium confidence
The highest severity findings point to setup instructions or local validation being unreliable.
The documentation may have drifted away from the actual repositorymedium confidence
The docs reference files or surfaces that are absent from the inspected file tree.

Activity Timeline

No commit history was available for this inspection.

Findings

Project identity: Stalled Notes App

info

A small note-taking app for developers who want a local scratchpad beside their editor.

[EV-001]

No git history was available

low

The analyzer could not read commit history for this local path.

[EV-002]

README references missing npm script: npm run dev

high

The setup instructions mention `npm run dev`, but package.json does not define a "dev" script.

[EV-003] [EV-004]

Dependencies exist without a lockfile

medium

The project declares npm dependencies but does not include a recognized lockfile, so installs may drift.

[EV-005]

No npm test script is defined

medium

The package has scripts, but no standard local validation command.

[EV-006]

Source code exists without a visible test surface

high

The repository has source files, but no test files or configured validation command were detected.

[EV-007]

Documented file is missing: docs/dashboard.png

medium

Documentation references `docs/dashboard.png`, but that file was not found in the repository snapshot.

[EV-008]

Revival Plan

TASK-001

Phase 1: Make setup reproducible

Fix the setup and install risks before adding product behavior.

Files: README.md, package.json
Verify: npm install && npm run build

TASK-002

Phase 2: Restore a local validation command

A revival needs one command that proves the current baseline.

Files: src/index.ts
Verify: npm test

TASK-003

Phase 5: Clean stale public documentation

Portfolio or handoff readers should not hit missing files from the README.

Files: README.md
Verify: Search README and docs links for missing local references

Snapshot

Source: local_path
Files: 4
Technology: next, npm, typescript
Schema: 1.0

Finding Severity

High2

29%

Medium3

43%

Low1

14%

Info1

14%

Finding Mix

Setup Risk3

43%

Docs Drift1

14%

Momentum Break1

14%

Project Identity1

14%

Validation Surface1

14%

Dependency Focus

Runtime deps1

33%

Dev deps1

33%

Scripts1

33%

Manifests: 1
Managers: npm
Runtime deps: 1
Dev deps: 1
Scripts: 1
Drift findings: 0

package.json

npm

Dependencies: next ^12.0.0
Dev dependencies: typescript ^4.9.0
Scripts: build tsc

Exports

Markdown

# Project Autopsy: Stalled Notes App

## Verdict

**Score:** 17/100
**Status:** at-risk

This repo is reviveable, but 2 high-severity issue(s) should be handled before feature work.

## Project Snapshot

- Source: local_path
- Files inspected: 4
- Latest commit: No commit history found
- Technologies: next, npm, typescript

## Activity Timeline

No commit history was available for this inspection.

## Dependency Focus

- Manifests: 1
- Managers: npm
- Runtime dependencies: 1
- Dev dependencies: 1
- Scripts: 1
- Drift findings: 0

## Dependency Snapshot

- **package.json** (npm)
  Dependencies: next ^12.0.0
  Dev dependencies: typescript ^4.9.0
  Scripts: build tsc

## Stall Hypotheses

1. **The project likely stalled around reproducibility and validation** (medium confidence)
   The highest severity findings point to setup instructions or local validation being unreliable.

2. **The documentation may have drifted away from the actual repository** (medium confidence)
   The docs reference files or surfaces that are absent from the inspected file tree.

## Top Findings

- **FINDING-001: Project identity: Stalled Notes App** (info)
  A small note-taking app for developers who want a local scratchpad beside their editor.
  Evidence: [EV-001]

- **FINDING-002: No git history was available** (low)
  The analyzer could not read commit history for this local path.
  Evidence: [EV-002]

- **FINDING-003: README references missing npm script: npm run dev** (high)
  The setup instructions mention `npm run dev`, but package.json does not define a "dev" script.
  Evidence: [EV-003], [EV-004]

- **FINDING-004: Dependencies exist without a lockfile** (medium)
  The project declares npm dependencies but does not include a recognized lockfile, so installs may drift.
  Evidence: [EV-005]

- **FINDING-005: No npm test script is defined** (medium)
  The package has scripts, but no standard local validation command.
  Evidence: [EV-006]

- **FINDING-006: Source code exists without a visible test surface** (high)
  The repository has source files, but no test files or configured validation command were detected.
  Evidence: [EV-007]

- **FINDING-007: Documented file is missing: docs/dashboard.png** (medium)
  Documentation references `docs/dashboard.png`, but that file was not found in the repository snapshot.
  Evidence: [EV-008]

## Revival Plan

- **TASK-001: Phase 1: Make setup reproducible**
  Fix the setup and install risks before adding product behavior.
  Files: README.md, package.json
  Evidence: [EV-003], [EV-004], [EV-005], [EV-006]
  Verify: `npm install && npm run build`
  Expected: Dependencies install from a lockfile and the documented build command works.

- **TASK-002: Phase 2: Restore a local validation command**
  A revival needs one command that proves the current baseline.
  Files: src/index.ts
  Evidence: [EV-007]
  Verify: `npm test`
  Expected: A repeatable test command exists and reports a clear result.

- **TASK-003: Phase 5: Clean stale public documentation**
  Portfolio or handoff readers should not hit missing files from the README.
  Files: README.md
  Evidence: [EV-008]
  Verify: `Search README and docs links for missing local references`
  Expected: Documented files either exist or the references are removed.

## Evidence Index

- **[EV-001]** README.md - A small note-taking app for developers who want a local scratchpad beside their editor.
- **[EV-002]** commit - git log returned no commits
- **[EV-003]** README.md - npm run dev
- **[EV-004]** package.json - Available scripts: build
- **[EV-005]** package.json - package.json declares dependencies or devDependencies
- **[EV-006]** package.json - Available scripts: build
- **[EV-007]** src/index.ts - 1 source file(s), 0 test files
- **[EV-008]** README.md - docs/dashboard.png

JSON

{
  "metadata": {
    "analyzerVersion": "0.3.0",
    "reportSchemaVersion": "1.0",
    "source": "local_path",
    "generatedAt": "1970-01-01T00:00:00.000Z"
  },
  "verdict": {
    "score": 17,
    "status": "at-risk",
    "summary": "This repo is reviveable, but 2 high-severity issue(s) should be handled before feature work."
  },
  "summary": {
    "projectName": "Stalled Notes App",
    "sourceType": "local_path",
    "fileCount": 4,
    "technologies": [
      "next",
      "npm",
      "typescript"
    ],
    "findingCounts": {
      "info": 1,
      "low": 1,
      "medium": 3,
      "high": 2
    }
  },
  "snapshot": {
    "sourceType": "local_path",
    "rootPath": "fixtures/stalled-npm-app",
    "fileCount": 4,
    "totalSizeBytes": 510,
    "languages": {
      "ts": 1
    },
    "files": [
      {
        "path": "docs/status.md",
        "extension": ".md",
        "sizeBytes": 58,
        "kind": "docs"
      },
      {
        "path": "package.json",
        "extension": ".json",
        "sizeBytes": 193,
        "kind": "config"
      },
      {
        "path": "README.md",
        "extension": ".md",
        "sizeBytes": 219,
        "kind": "docs"
      },
      {
        "path": "src/index.ts",
        "extension": ".ts",
        "sizeBytes": 40,
        "kind": "source"
      }
    ],
    "manifests": [
      {
        "path": "package.json",
        "manager": "npm",
        "parsed": {
          "name": "stalled-notes",
          "version": "0.1.0",
          "scripts": {
            "build": "tsc"
          },
          "dependencies": {
            "next": "^12.0.0"
          },
          "devDependencies": {
            "typescript": "^4.9.0"
          }
        },
        "scripts": {
          "build": "tsc"
        },
        "dependencies": {
          "next": "^12.0.0"
        },
        "devDependencies": {
          "typescript": "^4.9.0"
        }
      }
    ],
    "docs": [
      {
        "path": "README.md",
        "title": "Stalled Notes App",
        "content": "# Stalled Notes App\n\nA small note-taking app for developers who want a local scratchpad beside their editor.\n\n## Setup\n\nRun `npm install` and then `npm run dev`.\n\nThe dashboard screenshot lives at `docs/dashboard.png`.\n"
      },
      {
        "path": "docs/status.md",
        "title": "Status",
        "content": "# Status\n\nThe sync feature was planned but never started.\n"
      }
    ],
    "commits": [],
    "summary": {
      "projectName": "Stalled Notes App",
      "claimedValue": "A small note-taking app for developers who want a local scratchpad beside their editor.",
      "technologies": [
        "next",
        "npm",
        "typescript"
      ]
    }
  },
  "findings": [
    {
      "kind": "project-identity",
      "severity": "info",
      "title": "Project identity: Stalled Notes App",
      "body": "A small note-taking app for developers who want a local scratchpad beside their editor.",
      "evidence": [
        {
          "kind": "docs",
          "path": "README.md",
          "excerpt": "A small note-taking app for developers who want a local scratchpad beside their editor.",
          "id": "EV-001"
        }
      ],
      "id": "FINDING-001",
      "evidenceIds": [
        "EV-001"
      ]
    },
    {
      "kind": "momentum-break",
      "severity": "low",
      "title": "No git history was available",
      "body": "The analyzer could not read commit history for this local path.",
      "evidence": [
        {
          "kind": "commit",
          "excerpt": "git log returned no commits",
          "id": "EV-002"
        }
      ],
      "id": "FINDING-002",
      "evidenceIds": [
        "EV-002"
      ]
    },
    {
      "kind": "setup-risk",
      "severity": "high",
      "title": "README references missing npm script: npm run dev",
      "body": "The setup instructions mention `npm run dev`, but package.json does not define a \"dev\" script.",
      "evidence": [
        {
          "kind": "docs",
          "path": "README.md",
          "excerpt": "npm run dev",
          "id": "EV-003"
        },
        {
          "kind": "manifest",
          "path": "package.json",
          "excerpt": "Available scripts: build",
          "id": "EV-004"
        }
      ],
      "id": "FINDING-003",
      "evidenceIds": [
        "EV-003",
        "EV-004"
      ]
    },
    {
      "kind": "setup-risk",
      "severity": "medium",
      "title": "Dependencies exist without a lockfile",
      "body": "The project declares npm dependencies but does not include a recognized lockfile, so installs may drift.",
      "evidence": [
        {
          "kind": "manifest",
          "path": "package.json",
          "excerpt": "package.json declares dependencies or devDependencies",
          "id": "EV-005"
        }
      ],
      "id": "FINDING-004",
      "evidenceIds": [
        "EV-005"
      ]
    },
    {
      "kind": "setup-risk",
      "severity": "medium",
      "title": "No npm test script is defined",
      "body": "The package has scripts, but no standard local validation command.",
      "evidence": [
        {
          "kind": "manifest",
          "path": "package.json",
          "excerpt": "Available scripts: build",
          "id": "EV-006"
        }
      ],
      "id": "FINDING-005",
      "evidenceIds": [
        "EV-006"
      ]
    },
    {
      "kind": "validation-surface",
      "severity": "high",
      "title": "Source code exists without a visible test surface",
      "body": "The repository has source files, but no test files or configured validation command were detected.",
      "evidence": [
        {
          "kind": "file",
          "path": "src/index.ts",
          "excerpt": "1 source file(s), 0 test files",
          "id": "EV-007"
        }
      ],
      "id": "FINDING-006",
      "evidenceIds": [
        "EV-007"
      ]
    },
    {
      "kind": "docs-drift",
      "severity": "medium",
      "title": "Documented file is missing: docs/dashboard.png",
      "body": "Documentation references `docs/dashboard.png`, but that file was not found in the repository snapshot.",
      "evidence": [
        {
          "kind": "docs",
          "path": "README.md",
          "excerpt": "docs/dashboard.png",
          "id": "EV-008"
        }
      ],
      "id": "FINDING-007",
      "evidenceIds": [
        "EV-008"
      ]
    }
  ],
  "stallHypotheses": [
    {
      "rank": 1,
      "title": "The project likely stalled around reproducibility and validation",
      "confidence": "medium",
      "rationale": "The highest severity findings point to setup instructions or local validation being unreliable.",
      "supportingFindingKinds": [
        "setup-risk",
        "validation-surface"
      ]
    },
    {
      "rank": 2,
      "title": "The documentation may have drifted away from the actual repository",
      "confidence": "medium",
      "rationale": "The docs reference files or surfaces that are absent from the inspected file tree.",
      "supportingFindingKinds": [
        "docs-drift"
      ]
    }
  ],
  "revivalTasks": [
    {
      "phase": "Phase 1",
      "title": "Make setup reproducible",
      "rationale": "Fix the setup and install risks before adding product behavior.",
      "files": [
        "README.md",
        "package.json"
      ],
      "evidenceIds": [
        "EV-003",
        "EV-004",
        "EV-005",
        "EV-006"
      ],
      "verificationCommand": "npm install && npm run build",
      "expectedResult": "Dependencies install from a lockfile and the documented build command works.",
      "priority": 1,
      "id": "TASK-001"
    },
    {
      "phase": "Phase 2",
      "title": "Restore a local validation command",
      "rationale": "A revival needs one command that proves the current baseline.",
      "files": [
        "src/index.ts"
      ],
      "evidenceIds": [
        "EV-007"
      ],
      "verificationCommand": "npm test",
      "expectedResult": "A repeatable test command exists and reports a clear result.",
      "priority": 2,
      "id": "TASK-002"
    },
    {
      "phase": "Phase 5",
      "title": "Clean stale public documentation",
      "rationale": "Portfolio or handoff readers should not hit missing files from the README.",
      "files": [
        "README.md"
      ],
      "evidenceIds": [
        "EV-008"
      ],
      "verificationCommand": "Search README and docs links for missing local references",
      "expectedResult": "Documented files either exist or the references are removed.",
      "priority": 5,
      "id": "TASK-003"
    }
  ],
  "evidenceIndex": {
    "EV-001": {
      "kind": "docs",
      "path": "README.md",
      "excerpt": "A small note-taking app for developers who want a local scratchpad beside their editor.",
      "id": "EV-001"
    },
    "EV-002": {
      "kind": "commit",
      "excerpt": "git log returned no commits",
      "id": "EV-002"
    },
    "EV-003": {
      "kind": "docs",
      "path": "README.md",
      "excerpt": "npm run dev",
      "id": "EV-003"
    },
    "EV-004": {
      "kind": "manifest",
      "path": "package.json",
      "excerpt": "Available scripts: build",
      "id": "EV-004"
    },
    "EV-005": {
      "kind": "manifest",
      "path": "package.json",
      "excerpt": "package.json declares dependencies or devDependencies",
      "id": "EV-005"
    },
    "EV-006": {
      "kind": "manifest",
      "path": "package.json",
      "excerpt": "Available scripts: build",
      "id": "EV-006"
    },
    "EV-007": {
      "kind": "file",
      "path": "src/index.ts",
      "excerpt": "1 source file(s), 0 test files",
      "id": "EV-007"
    },
    "EV-008": {
      "kind": "docs",
      "path": "README.md",
      "excerpt": "docs/dashboard.png",
      "id": "EV-008"
    }
  }
}

Evidence Index

[EV-001]README.md

A small note-taking app for developers who want a local scratchpad beside their editor.

[EV-002]commit

git log returned no commits

[EV-003]README.md

npm run dev

[EV-004]package.json

Available scripts: build

[EV-005]package.json

package.json declares dependencies or devDependencies

[EV-006]package.json

Available scripts: build

[EV-007]src/index.ts

1 source file(s), 0 test files

[EV-008]README.md

docs/dashboard.png